filebrowser

filebrowser

Official

Docker app from logandwaters' Repository

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

[!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

Media gallery

1 / 6

Install Filebrowser on Unraid in a few clicks.

Find Filebrowser in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Filebrowser Review the template variables and paths Click Install

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

Download Statistics

173,020,631
Total Downloads
4,188,987
This Month
6,129,842
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Details

Repository
filebrowser/filebrowser
Last Updated2026-07-27
First Seen2019-03-01

Runtime arguments

Web UI
http://[IP]:[PORT:80]
Network
bridge
Shell
sh
Privileged
false

Template configuration

WebUI PortPort

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

Target
80
Default
8080
Path of Directory to AccessPath

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

Target
/srv
Default
/mnt/user
Path to ConfigPath

Stores configuration and settings.

Target
/config
Default
/mnt/user/appdata/filebrowser
Path to Database FilePath

Persistent database file for users and settings.

Target
/database.db
Default
/mnt/user/appdata/filebrowser/filebrowser.db
File Browser Database PathVariable

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

Target
FB_DATABASE
Default
/database.db