Snapshot Visualizer
Snapshot Visualizer
Get Started with Apps!
Get Started with Apps!
App Version:
1.5.0
(Changelog)
Keywords: zfs, snapshots, storage, treemap, disk usage
Train: Community
Home Page: https://github.com/synecho/truenas-snapshot-visualizer
Keywords: zfs, snapshots, storage, treemap, disk usage
Train: Community
Home Page: https://github.com/synecho/truenas-snapshot-visualizer
Snapshot Visualizer Details
Added: 2026-11-04
Last Updated: 2026-11-04
Added: 2026-11-04
Last Updated: 2026-11-04
Visualise ZFS snapshots like WinDirStat. A cushion treemap, a timeline and sortable tables show which datasets, snapshots and periodic snapshot tasks use your space, sorted by size, age and naming schema. Reads data through the TrueNAS API; deleting selected snapshots from the web UI is optional. HTTPS and an optional password protect the web UI.
Run as Context- Container [snapshot-visualizer] can run as any non-root user and group.
Group: 568 / Host group is [apps]
User: 568 / Host user is [apps]
Screenshots
×
![Full Screenshot]()
App Metadata (Raw File)
{
"1.0.0": {
"healthy": true,
"supported": true,
"healthy_error": null,
"location": "/__w/apps/apps/trains/community/snapshot-visualizer/1.0.0",
"last_update": "2026-11-04 16:45:05",
"required_features": [],
"human_version": "1.5.0_1.0.0",
"version": "1.0.0",
"app_metadata": {
"app_version": "1.5.0",
"capabilities": [],
"categories": [
"monitoring"
],
"changelog_url": "https://github.com/synecho/truenas-snapshot-visualizer/releases",
"date_added": "2026-11-04",
"description": "Visualise ZFS snapshots like WinDirStat. A cushion treemap, a timeline and sortable tables show which datasets, snapshots and periodic snapshot tasks use your space, sorted by size, age and naming schema. Reads data through the TrueNAS API; deleting selected snapshots from the web UI is optional. HTTPS and an optional password protect the web UI.",
"home": "https://github.com/synecho/truenas-snapshot-visualizer",
"host_mounts": [],
"icon": "https://media.sys.truenas.net/apps/snapshot-visualizer/icons/icon.png",
"keywords": [
"zfs",
"snapshots",
"storage",
"treemap",
"disk usage"
],
"lib_version": "2.3.18",
"lib_version_hash": "ed9839f681342ae8ca5f8c4c860ae22d0845a0919f472ba780d6edbc838f2633",
"maintainers": [
{
"email": "dev@truenas.com",
"name": "truenas",
"url": "https://www.truenas.com/"
}
],
"name": "snapshot-visualizer",
"run_as_context": [
{
"description": "Container [snapshot-visualizer] can run as any non-root user and group.",
"gid": 568,
"group_name": "Host group is [apps]",
"uid": 568,
"user_name": "Host user is [apps]"
}
],
"screenshots": [
"https://media.sys.truenas.net/apps/snapshot-visualizer/screenshots/screenshot1.png",
"https://media.sys.truenas.net/apps/snapshot-visualizer/screenshots/screenshot2.png",
"https://media.sys.truenas.net/apps/snapshot-visualizer/screenshots/screenshot3.png",
"https://media.sys.truenas.net/apps/snapshot-visualizer/screenshots/screenshot4.png"
],
"sources": [
"https://apps.truenas.com/catalog/snapshot-visualizer_community/",
"https://github.com/synecho/truenas-snapshot-visualizer"
],
"title": "Snapshot Visualizer",
"train": "community",
"version": "1.0.0"
},
"schema": {
"groups": [
{
"name": "Snapshot Visualizer Configuration",
"description": "Configure Snapshot Visualizer"
},
{
"name": "User and Group Configuration",
"description": "Configure User and Group for Snapshot Visualizer"
},
{
"name": "Network Configuration",
"description": "Configure Network for Snapshot Visualizer"
},
{
"name": "Storage Configuration",
"description": "Configure Storage for Snapshot Visualizer"
},
{
"name": "Labels Configuration",
"description": "Configure Labels for Snapshot Visualizer"
},
{
"name": "Resources Configuration",
"description": "Configure Resources for Snapshot Visualizer"
}
],
"questions": [
{
"variable": "TZ",
"group": "Snapshot Visualizer Configuration",
"label": "Timezone",
"schema": {
"type": "string",
"default": "Etc/UTC",
"required": true,
"$ref": [
"definitions/timezone"
]
}
},
{
"variable": "snapshot_visualizer",
"label": "",
"group": "Snapshot Visualizer Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "api_key",
"label": "TrueNAS API Key",
"description": "API key used to read datasets and snapshots. The app only performs read-only queries\nunless \"Allow Deleting Snapshots\" is enabled.</br>\nRecommended: create a dedicated user in a group with the Read-Only Administrator privilege\n(Credentials > Users / Groups), then create an API key for it (user menu > My API Keys).\n",
"schema": {
"type": "string",
"default": "",
"private": true,
"required": true
}
},
{
"variable": "cache_minutes",
"label": "Cache Duration (minutes)",
"description": "How long snapshot data is cached before it is fetched again. The Refresh button always fetches fresh data.",
"schema": {
"type": "int",
"default": 5,
"min": 0,
"max": 1440,
"required": true
}
},
{
"variable": "allow_import",
"label": "Allow Import of zfs list Output",
"description": "Allow uploading the output of `zfs list` in the web UI to visualise snapshots of other systems. Uploaded data is never stored.",
"schema": {
"type": "boolean",
"default": true
}
},
{
"variable": "use_https",
"label": "Use HTTPS",
"description": "Serve the web UI over HTTPS with an automatically generated self-signed certificate.</br>\nYour browser shows a certificate warning once (like for the TrueNAS web interface).\n",
"schema": {
"type": "boolean",
"default": true
}
},
{
"variable": "password",
"label": "Web UI Password",
"description": "Password required to open the web UI. Leave empty to allow access without login.</br>\nStrongly recommended when deleting snapshots is allowed.\n",
"schema": {
"type": "string",
"default": "",
"private": true
}
},
{
"variable": "allow_delete",
"label": "Allow Deleting Snapshots",
"description": "When enabled, deleting snapshots can be switched on in the web UI settings (per browser)\nand every deletion needs a double confirmation. Disable to lock deleting completely.</br>\nSnapshots managed by TrueNAS (boot environments, system and app datasets) can never be deleted.</br>\nWithout a Web UI Password anyone who can reach the web UI can switch deleting on.</br>\nThe API key's user needs the SNAPSHOT_DELETE role (e.g. Full Admin); Read-Only Administrator can only view.\n",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "additional_envs",
"label": "Additional Environment Variables",
"schema": {
"type": "list",
"default": [],
"items": [
{
"variable": "env",
"label": "Environment Variable",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "name",
"label": "Name",
"schema": {
"type": "string",
"required": true
}
},
{
"variable": "value",
"label": "Value",
"schema": {
"type": "string"
}
}
]
}
}
]
}
}
]
}
},
{
"variable": "run_as",
"label": "",
"group": "User and Group Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "user",
"label": "User ID",
"description": "The user id that Snapshot Visualizer files will be owned by.",
"schema": {
"type": "int",
"min": 568,
"default": 568,
"required": true
}
},
{
"variable": "group",
"label": "Group ID",
"description": "The group id that Snapshot Visualizer files will be owned by.",
"schema": {
"type": "int",
"min": 568,
"default": 568,
"required": true
}
}
]
}
},
{
"variable": "network",
"label": "",
"group": "Network Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "web_port",
"label": "WebUI Port",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "bind_mode",
"label": "Port Bind Mode",
"description": "The port bind mode.</br>\n- Publish: The port will be published on the host for external access.</br>\n- Expose: The port will be exposed for inter-container communication.</br>\n- None: The port will not be exposed or published.</br>\nNote: If the Dockerfile defines an EXPOSE directive,\nthe port will still be exposed for inter-container communication regardless of this setting.\n",
"schema": {
"type": "string",
"default": "published",
"enum": [
{
"value": "published",
"description": "Publish port on the host for external access"
},
{
"value": "exposed",
"description": "Expose port for inter-container communication"
},
{
"value": "",
"description": "None"
}
]
}
},
{
"variable": "port_number",
"label": "Port Number",
"schema": {
"type": "int",
"default": 30550,
"min": 1,
"max": 65535,
"required": true
}
},
{
"variable": "host_ips",
"label": "Host IPs",
"description": "IPs on the host to bind this port",
"schema": {
"type": "list",
"show_if": [
[
"bind_mode",
"=",
"published"
]
],
"default": [],
"items": [
{
"variable": "host_ip",
"label": "Host IP",
"schema": {
"type": "string",
"required": true,
"$ref": [
"definitions/node_bind_ip"
]
}
}
]
}
}
]
}
},
{
"variable": "networks",
"label": "Networks",
"description": "The docker networks to join",
"schema": {
"type": "list",
"show_if": [
[
"host_network",
"=",
false
]
],
"default": [],
"items": [
{
"variable": "network",
"label": "Network",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "name",
"label": "Name",
"description": "The name of the network to join.</br>\nThe network must already exist.\n",
"schema": {
"type": "string",
"default": "",
"required": true
}
},
{
"variable": "containers",
"label": "Containers",
"description": "The containers to add to this network.",
"schema": {
"type": "list",
"items": [
{
"variable": "container",
"label": "Container",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "name",
"label": "Container Name",
"schema": {
"type": "string",
"required": true,
"enum": [
{
"value": "snapshot-visualizer",
"description": "snapshot-visualizer"
}
]
}
},
{
"variable": "config",
"label": "Container Network Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "aliases",
"label": "Aliases (Optional)",
"description": "The network aliases to use for this container on this network.",
"schema": {
"type": "list",
"default": [],
"items": [
{
"variable": "alias",
"label": "Alias",
"schema": {
"type": "string"
}
}
]
}
},
{
"variable": "interface_name",
"label": "Interface Name (Optional)",
"description": "The network interface name to use for this network",
"schema": {
"type": "string"
}
},
{
"variable": "mac_address",
"label": "MAC Address (Optional)",
"description": "The MAC address to use for this network interface.",
"schema": {
"type": "string"
}
},
{
"variable": "ipv4_address",
"label": "IPv4 Address (Optional)",
"description": "The IPv4 address to use for this network interface.",
"schema": {
"type": "string"
}
},
{
"variable": "ipv6_address",
"label": "IPv6 Address (Optional)",
"description": "The IPv6 address to use for this network interface.",
"schema": {
"type": "string"
}
},
{
"variable": "gw_priority",
"label": "Gateway Priority (Optional)",
"description": "Indicates the priority of the gateway for this network interface.",
"schema": {
"type": "int",
"null": true
}
},
{
"variable": "priority",
"label": "Priority (Optional)",
"description": "Indicates in which order Compose connects the service\u2019s containers to its networks.",
"schema": {
"type": "int",
"null": true
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
},
{
"variable": "host_network",
"label": "Host Network",
"description": "Bind to the host network. It's recommended to keep this disabled.\n",
"schema": {
"type": "boolean",
"default": false
}
}
]
}
},
{
"variable": "storage",
"label": "",
"group": "Storage Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "data",
"label": "SData Storage",
"description": "The path to store data (TLS certificate and session key).",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "type",
"label": "Type",
"description": "ixVolume: Is dataset created automatically by the system.</br>\nHost Path: Is a path that already exists on the system.\n",
"schema": {
"type": "string",
"required": true,
"default": "ix_volume",
"enum": [
{
"value": "host_path",
"description": "Host Path (Path that already exists on the system)"
},
{
"value": "ix_volume",
"description": "ixVolume (Dataset created automatically by the system)"
}
]
}
},
{
"variable": "ix_volume_config",
"label": "ixVolume Configuration",
"description": "The configuration for the ixVolume dataset.",
"schema": {
"type": "dict",
"show_if": [
[
"type",
"=",
"ix_volume"
]
],
"$ref": [
"normalize/ix_volume"
],
"attrs": [
{
"variable": "acl_enable",
"label": "Enable ACL",
"description": "Enable ACL for the storage.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "dataset_name",
"label": "Dataset Name",
"description": "The name of the dataset to use for storage.",
"schema": {
"type": "string",
"required": true,
"hidden": true,
"default": "data"
}
},
{
"variable": "acl_entries",
"label": "ACL Configuration",
"schema": {
"type": "dict",
"show_if": [
[
"acl_enable",
"=",
true
]
],
"attrs": []
}
}
]
}
},
{
"variable": "host_path_config",
"label": "Host Path Configuration",
"schema": {
"type": "dict",
"show_if": [
[
"type",
"=",
"host_path"
]
],
"attrs": [
{
"variable": "acl_enable",
"label": "Enable ACL",
"description": "Enable ACL for the storage.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "acl",
"label": "ACL Configuration",
"schema": {
"type": "dict",
"show_if": [
[
"acl_enable",
"=",
true
]
],
"attrs": [],
"$ref": [
"normalize/acl"
]
}
},
{
"variable": "path",
"label": "Host Path",
"description": "The host path to use for storage.",
"schema": {
"type": "hostpath",
"show_if": [
[
"acl_enable",
"=",
false
]
],
"required": true
}
}
]
}
}
]
}
},
{
"variable": "additional_storage",
"label": "Additional Storage",
"schema": {
"type": "list",
"default": [],
"items": [
{
"variable": "storage_entry",
"label": "Storage Entry",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "type",
"label": "Type",
"description": "ixVolume: Is dataset created automatically by the system.</br>\nHost Path: Is a path that already exists on the system.</br>\nSMB Share: Is a SMB share that is mounted to as a volume.</br>\nNFS Share: Is a NFS share that is mounted to as a volume.\n",
"schema": {
"type": "string",
"required": true,
"default": "ix_volume",
"enum": [
{
"value": "host_path",
"description": "Host Path (Path that already exists on the system)"
},
{
"value": "ix_volume",
"description": "ixVolume (Dataset created automatically by the system)"
},
{
"value": "cifs",
"description": "SMB/CIFS Share (Mounts a volume to a SMB share)"
},
{
"value": "nfs",
"description": "NFS Share (Mounts a volume to a NFS share)"
}
]
}
},
{
"variable": "read_only",
"label": "Read Only",
"description": "Mount the volume as read only.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "mount_path",
"label": "Mount Path",
"description": "The path inside the container to mount the storage.",
"schema": {
"type": "path",
"required": true
}
},
{
"variable": "host_path_config",
"label": "Host Path Configuration",
"schema": {
"type": "dict",
"show_if": [
[
"type",
"=",
"host_path"
]
],
"attrs": [
{
"variable": "acl_enable",
"label": "Enable ACL",
"description": "Enable ACL for the storage.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "acl",
"label": "ACL Configuration",
"schema": {
"type": "dict",
"show_if": [
[
"acl_enable",
"=",
true
]
],
"attrs": [],
"$ref": [
"normalize/acl"
]
}
},
{
"variable": "path",
"label": "Host Path",
"description": "The host path to use for storage.",
"schema": {
"type": "hostpath",
"show_if": [
[
"acl_enable",
"=",
false
]
],
"required": true
}
}
]
}
},
{
"variable": "ix_volume_config",
"label": "ixVolume Configuration",
"description": "The configuration for the ixVolume dataset.",
"schema": {
"type": "dict",
"show_if": [
[
"type",
"=",
"ix_volume"
]
],
"$ref": [
"normalize/ix_volume"
],
"attrs": [
{
"variable": "acl_enable",
"label": "Enable ACL",
"description": "Enable ACL for the storage.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "dataset_name",
"label": "Dataset Name",
"description": "The name of the dataset to use for storage.",
"schema": {
"type": "string",
"required": true,
"default": "storage_entry"
}
},
{
"variable": "acl_entries",
"label": "ACL Configuration",
"schema": {
"type": "dict",
"show_if": [
[
"acl_enable",
"=",
true
]
],
"attrs": [],
"$ref": [
"normalize/acl"
]
}
}
]
}
},
{
"variable": "cifs_config",
"label": "SMB Configuration",
"description": "The configuration for the SMB dataset.",
"schema": {
"type": "dict",
"show_if": [
[
"type",
"=",
"cifs"
]
],
"attrs": [
{
"variable": "server",
"label": "Server",
"description": "The server to mount the SMB share.",
"schema": {
"type": "string",
"required": true
}
},
{
"variable": "path",
"label": "Path",
"description": "The path to mount the SMB share.",
"schema": {
"type": "string",
"required": true
}
},
{
"variable": "username",
"label": "Username",
"description": "The username to use for the SMB share.",
"schema": {
"type": "string",
"required": true
}
},
{
"variable": "password",
"label": "Password",
"description": "The password to use for the SMB share.",
"schema": {
"type": "string",
"required": true,
"private": true
}
},
{
"variable": "domain",
"label": "Domain",
"description": "The domain to use for the SMB share.",
"schema": {
"type": "string"
}
}
]
}
},
{
"variable": "nfs_config",
"label": "NFS Configuration",
"description": "The configuration for the NFS dataset.",
"schema": {
"type": "dict",
"show_if": [
[
"type",
"=",
"nfs"
]
],
"attrs": [
{
"variable": "server",
"label": "Server",
"description": "The server to mount the NFS share.",
"schema": {
"type": "string",
"required": true
}
},
{
"variable": "path",
"label": "Path",
"description": "The path to mount the NFS share.",
"schema": {
"type": "string",
"required": true
}
}
]
}
}
]
}
}
]
}
}
]
}
},
{
"variable": "labels",
"label": "",
"group": "Labels Configuration",
"schema": {
"type": "list",
"default": [],
"items": [
{
"variable": "label",
"label": "Label",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "key",
"label": "Key",
"schema": {
"type": "string",
"required": true
}
},
{
"variable": "value",
"label": "Value",
"schema": {
"type": "string",
"required": true
}
},
{
"variable": "containers",
"label": "Containers",
"description": "Containers where the label should be applied",
"schema": {
"type": "list",
"items": [
{
"variable": "container",
"label": "Container",
"schema": {
"type": "string",
"required": true,
"enum": [
{
"value": "snapshot-visualizer",
"description": "snapshot-visualizer"
}
]
}
}
]
}
}
]
}
}
]
}
},
{
"variable": "resources",
"label": "",
"group": "Resources Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "limits",
"label": "Limits",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "cpus",
"label": "CPUs",
"description": "CPUs limit for Snapshot Visualizer.",
"schema": {
"type": "int",
"default": 2,
"required": true
}
},
{
"variable": "memory",
"label": "Memory (in MB)",
"description": "Memory limit for Snapshot Visualizer.",
"schema": {
"type": "int",
"default": 4096,
"required": true
}
}
]
}
}
]
}
}
]
},
"readme": "<h1>Snapshot Visualizer</h1> <p><a href=\"https://github.com/synecho/truenas-snapshot-visualizer\">Snapshot Visualizer</a> shows the ZFS snapshots of your TrueNAS system the way WinDirStat shows files: a cushion treemap by size, a timeline by age, per-dataset statistics and a sortable snapshot table, so you can quickly see which snapshots and periodic tasks use your space.</p> <!-- x-readme:warnings:start --> <p>\u26a0\ufe0f <strong>WARNING:</strong> This app requires a TrueNAS API key, which gives it administrative control over the system.</p> <p>Misconfiguration or a malicious update can compromise data integrity, security, or system stability. Install at your own risk.</p> <!-- x-readme:warnings:end -->",
"changelog": null,
"chart_metadata": {
"app_version": "1.5.0",
"capabilities": [],
"categories": [
"monitoring"
],
"changelog_url": "https://github.com/synecho/truenas-snapshot-visualizer/releases",
"date_added": "2026-11-04",
"description": "Visualise ZFS snapshots like WinDirStat. A cushion treemap, a timeline and sortable tables show which datasets, snapshots and periodic snapshot tasks use your space, sorted by size, age and naming schema. Reads data through the TrueNAS API; deleting selected snapshots from the web UI is optional. HTTPS and an optional password protect the web UI.",
"home": "https://github.com/synecho/truenas-snapshot-visualizer",
"host_mounts": [],
"icon": "https://media.sys.truenas.net/apps/snapshot-visualizer/icons/icon.png",
"keywords": [
"zfs",
"snapshots",
"storage",
"treemap",
"disk usage"
],
"lib_version": "2.3.18",
"lib_version_hash": "ed9839f681342ae8ca5f8c4c860ae22d0845a0919f472ba780d6edbc838f2633",
"maintainers": [
{
"email": "dev@truenas.com",
"name": "truenas",
"url": "https://www.truenas.com/"
}
],
"name": "snapshot-visualizer",
"run_as_context": [
{
"description": "Container [snapshot-visualizer] can run as any non-root user and group.",
"gid": 568,
"group_name": "Host group is [apps]",
"uid": 568,
"user_name": "Host user is [apps]"
}
],
"screenshots": [
"https://media.sys.truenas.net/apps/snapshot-visualizer/screenshots/screenshot1.png",
"https://media.sys.truenas.net/apps/snapshot-visualizer/screenshots/screenshot2.png",
"https://media.sys.truenas.net/apps/snapshot-visualizer/screenshots/screenshot3.png",
"https://media.sys.truenas.net/apps/snapshot-visualizer/screenshots/screenshot4.png"
],
"sources": [
"https://apps.truenas.com/catalog/snapshot-visualizer_community/",
"https://github.com/synecho/truenas-snapshot-visualizer"
],
"title": "Snapshot Visualizer",
"train": "community",
"version": "1.0.0"
}
}
}Support, maintenance, and documentation for applications within the Community catalog is handled by the TrueNAS community. The TrueNAS Applications Market hosts but does not validate or maintain any linked resources associated with this app.
There currently aren’t any resources available for this application!
Please help the TrueNAS community add resources here or discuss this application in the TrueNAS Community forum.