File Browser
File Browser
Get Started with Apps!
Get Started with Apps!
App Version: v2.32.0
(Changelog)
Keywords: files, browser
Train: Community
Home Page: https://filebrowser.org
Keywords: files, browser
Train: Community
Home Page: https://filebrowser.org
File Browser Details
Added: 2024-08-02
Last Updated: 2025-04-23
Added: 2024-08-02
Last Updated: 2025-04-23
File Browser provides a file managing interface within a specified directory and it can be used to upload, delete, preview, rename and edit your files.
Run as Context- File Browser runs as any non-root user.
Group: 568 / filebrowser runs as any non-root user.
User: 568 / filebrowser runs as any non-root user.
Screenshots
×
![Full Screenshot]()
App Metadata (Raw File)
{
"1.2.12": {
"healthy": true,
"supported": true,
"healthy_error": null,
"location": "/__w/apps/apps/trains/community/filebrowser/1.2.12",
"last_update": "2025-04-23 17:40:39",
"required_features": [],
"human_version": "v2.32.0_1.2.12",
"version": "1.2.12",
"app_metadata": {
"app_version": "v2.32.0",
"capabilities": [],
"categories": [
"storage"
],
"changelog_url": "https://github.com/filebrowser/filebrowser/releases",
"date_added": "2024-08-02",
"description": "File Browser provides a file managing interface within a specified directory and it can be used to upload, delete, preview, rename and edit your files.",
"home": "https://filebrowser.org",
"host_mounts": [],
"icon": "https://media.sys.truenas.net/apps/filebrowser/icons/icon.png",
"keywords": [
"files",
"browser"
],
"lib_version": "2.1.16",
"lib_version_hash": "dac15686f882b9ce65b8549a3d5c0ed7bafe2df7a9028880d1a99b0ff4af1eff",
"maintainers": [
{
"email": "dev@ixsystems.com",
"name": "truenas",
"url": "https://www.truenas.com/"
}
],
"name": "filebrowser",
"run_as_context": [
{
"description": "File Browser runs as any non-root user.",
"gid": 568,
"group_name": "filebrowser runs as any non-root user.",
"uid": 568,
"user_name": "filebrowser runs as any non-root user."
}
],
"screenshots": [
"https://media.sys.truenas.net/apps/filebrowser/screenshots/screenshot1.png",
"https://media.sys.truenas.net/apps/filebrowser/screenshots/screenshot2.png",
"https://media.sys.truenas.net/apps/filebrowser/screenshots/screenshot3.png"
],
"sources": [
"https://github.com/filebrowser/filebrowser",
"https://hub.docker.com/r/filebrowser/filebrowser"
],
"title": "File Browser",
"train": "community",
"version": "1.2.12"
},
"schema": {
"groups": [
{
"name": "File Browser Configuration",
"description": "Configure File Browser"
},
{
"name": "User and Group Configuration",
"description": "Configure User and Group for File Browser"
},
{
"name": "Network Configuration",
"description": "Configure Network for File Browser"
},
{
"name": "Storage Configuration",
"description": "Configure Storage for File Browser"
},
{
"name": "Labels Configuration",
"description": "Configure Labels for File Browser"
},
{
"name": "Resources Configuration",
"description": "Configure Resources for File Browser"
}
],
"questions": [
{
"variable": "filebrowser",
"label": "",
"group": "File Browser Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "additional_envs",
"label": "Additional Environment Variables",
"description": "Configure additional environment variables for File Browser.",
"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",
"required": true
}
}
]
}
}
]
}
}
]
}
},
{
"variable": "run_as",
"label": "",
"group": "User and Group Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "user",
"label": "User ID",
"description": "The user id that File Browser files will be owned by.",
"schema": {
"type": "int",
"min": 0,
"default": 568,
"required": true
}
},
{
"variable": "group",
"label": "Group ID",
"description": "The group id that File Browser files will be owned by.",
"schema": {
"type": "int",
"min": 0,
"default": 568,
"required": true
}
}
]
}
},
{
"variable": "network",
"label": "",
"group": "Network Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "web_port",
"label": "WebUI Port",
"description": "The port for File Browser WebUI",
"schema": {
"type": "int",
"default": 30051,
"required": true,
"$ref": [
"definitions/port"
]
}
},
{
"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": "certificate_id",
"label": "Certificate ID",
"description": "The certificate id to use for the https endpoint.",
"schema": {
"type": "int",
"null": true,
"$ref": [
"definitions/certificate"
]
}
}
]
}
},
{
"variable": "storage",
"label": "",
"group": "Storage Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "config",
"label": "File Browser Config Storage",
"description": "The path to store File Browser Config.",
"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,
"immutable": 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,
"immutable": true,
"hidden": true,
"default": "config"
}
},
{
"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",
"description": "Additional storage for File Browser.",
"schema": {
"type": "list",
"min_length": 1,
"default": [],
"items": [
{
"variable": "storageEntry",
"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.\n",
"schema": {
"type": "string",
"required": true,
"default": "ix_volume",
"immutable": true,
"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)"
}
]
}
},
{
"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,
"immutable": 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": "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": "filebrowser",
"description": "filebrowser"
}
]
}
}
]
}
}
]
}
}
]
}
},
{
"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 File Browser.",
"schema": {
"type": "int",
"default": 2,
"required": true
}
},
{
"variable": "memory",
"label": "Memory (in MB)",
"description": "Memory limit for File Browser.",
"schema": {
"type": "int",
"default": 4096,
"required": true
}
}
]
}
}
]
}
}
]
},
"readme": "<h1>Filebrowser</h1> <p><a href=\"https://filebrowser.org\">Filebrowser</a> provides a file managing interface within a specified directory and it can be used to upload, delete, preview, rename and edit your files.</p> <p>You can configure further the settings by using Environment Variables. See <a href=\"https://filebrowser.org/cli/filebrowser\">Filebrowser Documentation</a> for more information. Use the format <code>FB_OPTION_NAME</code> where the option name is the name of the option you want to set.</p> <p>You can also edit the configuration file <code>/config/filebrowser.json</code>.</p> <p>Note that the following options are already set and will always take precedence over the environment variables and the configuration file:</p> <ul> <li><code>FB_ROOT</code>/<code>--root</code> is set to <code>/data</code> (Any additional volume mounted will be under this directory)</li> <li><code>FB_PORT</code>/<code>--port</code> is set to <code>30044</code> (Or the port you configured in the installation wizard)</li> <li><code>FB_ADDRESS</code>/<code>--address</code> is set to <code>0.0.0.0</code> (It will listen on all interfaces <strong>inside</strong> the container)</li> <li><code>FB_DATABASE</code>/<code>--database</code> is set to <code>/config/filebrowser.db</code></li> <li><code>FB_CONFIG</code>/<code>--config</code> is set to <code>/config/filebrowser.json</code></li> </ul> <p>Also when a certificate is selected</p> <ul> <li><code>FB_CERT</code>/<code>--cert</code> is set to <code>/config/certs/tls.crt</code></li> <li><code>FB_KEY</code>/<code>--key</code> is set to <code>/config/certs/tls.key</code></li> </ul>",
"changelog": null,
"chart_metadata": {
"app_version": "v2.32.0",
"capabilities": [],
"categories": [
"storage"
],
"changelog_url": "https://github.com/filebrowser/filebrowser/releases",
"date_added": "2024-08-02",
"description": "File Browser provides a file managing interface within a specified directory and it can be used to upload, delete, preview, rename and edit your files.",
"home": "https://filebrowser.org",
"host_mounts": [],
"icon": "https://media.sys.truenas.net/apps/filebrowser/icons/icon.png",
"keywords": [
"files",
"browser"
],
"lib_version": "2.1.16",
"lib_version_hash": "dac15686f882b9ce65b8549a3d5c0ed7bafe2df7a9028880d1a99b0ff4af1eff",
"maintainers": [
{
"email": "dev@ixsystems.com",
"name": "truenas",
"url": "https://www.truenas.com/"
}
],
"name": "filebrowser",
"run_as_context": [
{
"description": "File Browser runs as any non-root user.",
"gid": 568,
"group_name": "filebrowser runs as any non-root user.",
"uid": 568,
"user_name": "filebrowser runs as any non-root user."
}
],
"screenshots": [
"https://media.sys.truenas.net/apps/filebrowser/screenshots/screenshot1.png",
"https://media.sys.truenas.net/apps/filebrowser/screenshots/screenshot2.png",
"https://media.sys.truenas.net/apps/filebrowser/screenshots/screenshot3.png"
],
"sources": [
"https://github.com/filebrowser/filebrowser",
"https://hub.docker.com/r/filebrowser/filebrowser"
],
"title": "File Browser",
"train": "community",
"version": "1.2.12"
}
}
}Support, maintenance, and documentation for applications within the Community catalog is handled by the TrueNAS community. The TrueNAS Applications Portal 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 create content or discuss this application in the TrueNAS Community forum.