filebrowser

filebrowser

apps.detail.official

apps.detail.types.app from logandwaters' Repository

apps.detail.sections.overview

File Browser provides a file management interface within a specified directory and can be used to upload, delete, preview, rename and edit your files. It allows the creation of multiple users where each can have its own directories, permissions & rules.

This software was created by the File Browser team & pulls from the official Docker registry. Please note, this project is in maintenance-only mode.

Install Instructions:

  1. Run the commands outlined under "Additional Requirements".
  2. Pull the container, set webUI port & directory for access, then deploy.
  3. On first launch, check container logs for the randomly generated admin password.
  4. Login to the webUI using the default username "admin" and the generated password.
  5. Changing the password immediately is highly recommended.

Helpful links:
GitHub Repo: https://github.com/filebrowser/filebrowser
Docker Registry: https://hub.docker.com/r/filebrowser/filebrowser
Documentation: https://filebrowser.org/
Report Software Issues: https://github.com/filebrowser/filebrowser/issues
Report Container Template Issue: https://github.com/logandwaters/Unraid-docker-templates/issues

Readme

View on GitHub

[!WARNING]

File Browser is archived on 2026-09-01. The last planned release has already shipped. There will be no further releases, bug fixes, or security fixes.

File Browser provides a file managing interface within a specified directory and it can be used to upload, delete, preview and edit your files. It is a create-your-own-cloud-kind of software where you can just install it on your server, direct it to a path and access your files through a nice web interface.

Background: Goodbye File Browser, for Real This Time, July 2026.

Security

Published advisories are listed under security advisories, and reporting instructions are in SECURITY.md. Two known issue classes remain unaddressed and will not be fixed:

  • Command execution, runner, and hooks. This feature is plagued with vulnerabilities across many published advisories, and would need a full rewrite to be made safe. It is disabled by default; if you re-enable it with --disable-exec=false, treat the ability to run commands as equivalent to shell access on the host. Background: #5199.
  • Session and JWT handling. Sessions are self-contained JWTs rather than server-side identifiers, so they cannot be revoked, which means that logout, password changes, and renewal leave previously issued tokens valid until they expire, and the same refresh token can be redeemed repeatedly. Assume a leaked token is valid until expiry. Background: #5216.

If you keep running File Browser, treat it as unmaintained software:

  • Do not expose it directly to the internet. Put it behind a reverse proxy that terminates TLS and performs its own authentication.
  • Keep the command runner disabled. It is off by default, so leave it off. See #5199 and docs/command-execution.md.
  • Run it unprivileged, inside a container, with only the directory you intend to serve mounted into it.

Documentation

Documentation on how to install, configure, and build this project lives in docs in this repository.

CONTRIBUTING.md documents how to build and develop the project, which remains useful to anyone forking it.

License

Apache License 2.0 © File Browser Contributors

apps.detail.sections.mediaGallery

1 / 6

apps.marketingCta.appInstallTitle

apps.marketingCta.appInstallDescription

apps.installHelp.stepOpen apps.installHelp.stepSearchApp apps.installHelp.stepReview apps.installHelp.stepInstall
apps.marketingCta.secondary

apps.detail.sections.requirements

Before pulling the container, run the following in the Unraid terminal to create the required paths and permissions:

mkdir -p /mnt/user/appdata/filebrowser
touch /mnt/user/appdata/filebrowser/filebrowser.db
chown -R 1000:1000 /mnt/user/appdata/filebrowser
chmod -R 775 /mnt/user/appdata/filebrowser

apps.detail.sections.categories

OtherProductivityTools > Utilities

apps.downloadStats.title

168,831,644
apps.downloadStats.metrics.totalDownloads
11,892,675
apps.downloadStats.metrics.thisMonth
6,289,002
apps.downloadStats.metrics.avgPerMonth

apps.downloadStats.chart.totalOverTime

apps.downloadStats.chart.loading

apps.detail.sections.related

apps.detail.related.exploreCategories

apps.detail.related.exploreAll
OtherProductivityapps.detail.related.categoryApps

apps.detail.sections.links

apps.detail.links.projectgithub.comapps.detail.links.supportgithub.comapps.detail.repositorySources.dockerHubhub.docker.comapps.detail.links.templateraw.githubusercontent.com

apps.detail.sections.details

apps.detail.details.repository
filebrowser/filebrowser
apps.detail.details.registry
https://hub.docker.com/r/filebrowser/filebrowser
apps.detail.details.lastUpdated2026-07-04
apps.detail.details.firstSeen2019-03-01

apps.detail.sections.runtime

apps.detail.details.webui
http://[IP]:[PORT:80]
apps.detail.details.network
bridge
apps.detail.details.shell
sh
apps.detail.details.privileged
false

apps.detail.sections.configuration

WebUI PortPort

Host port (Default 8080) mapped to container port 80 for UI access.

apps.detail.config.target
80
apps.detail.config.default
8080
Path of Directory to AccessPath

Directory to access within the UI. (Customize as needed)

apps.detail.config.target
/srv
apps.detail.config.default
/mnt/user
Path to ConfigPath

Stores configuration and settings.

apps.detail.config.target
/config
apps.detail.config.default
/mnt/user/appdata/filebrowser
Path to Database FilePath

Persistent database file for users and settings.

apps.detail.config.target
/database.db
apps.detail.config.default
/mnt/user/appdata/filebrowser/filebrowser.db
File Browser Database PathVariable

Forces File Browser to use the mapped database file for persistence.

apps.detail.config.target
FB_DATABASE
apps.detail.config.default
/database.db