File Browser

File Browser is a create-your-own-cloud-kind of software where you can install it on a server, direct it to a path and then access your files through a nice web interface.

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. It allows the creation of multiple users and each user can have its own directory. It can be used as a standalone app.

Please read our disclaimer



Docker Template from the Community Apps

FileBrowser / knex666's Repository / Cloud

  1. Leave on Custom: br0 .

  2. Give it a fixed and free IP address in your local network.

  3. Defining the entry point to the files and directories you want to have access to and share. Can be a share like /mnt/user/filebrowser or /mnt to have access to all Unraid shares, unassigned devices and remote shares.

Click APPLY to install.

Open the WebUI and continue with First Start


docker run \
    -v /path/to/root:/srv \
    -v /path/to/filebrowser.db:/database/filebrowser.db \
    -v /path/to/settings.json:/config/settings.json \
    -e PUID=$(id -u) \
    -e PGID=$(id -g) \
    -p 8080:80 \

By default, File Browser already has a configuration file with some defaults so you can just mount the root and the database. Although you can overwrite by mounting a directory with a new config file. If you don't already have a database file, make sure to create a new empty file under the path you specified. Otherwise, Docker will create an empty folder instead of an empty file, resulting in an error when mounting the database into the container.

Docker Compose

version: '3.1'

    image: filebrowser/filebrowser:s6
    container_name: filebrowser
    restart: always
      - /opt/filebrowser:/srv
      - /opt/filebrowser/database/filebrowser.db:/database.db 
      - /opt/filebrowser/config/filebrowser.json:/filebrowser.json
      - 8080:80
      - PUID=1000
      - PGID=1000
      - proxy
      traefik.enable: true
      traefik.http.routers.filebrowser.entryPoints: https
      traefik.http.routers.filebrowser.middlewares: auth@file
    restart: unless-stopped

    driver: bridge
    external: true

Reverse Proxy

Please find three Videos about Reverse Proxy in the "Related Videos" tab. All three will work great with File Browser.

Other Installation Options

First Start and Password Change

First time Username is admin with the Password admin.

First things first...

Click on 1 Settings, 2 User Management and 3 edit the admin user. Enter a new password and click SAVE at the bottom to secure your File Browser installation.


File Browser has many Settings. Here are some examples that get you started:

  • User Default Language Under the Global Settings, User default settings (the box on the right) you can pick, amongst other settings, the Language that Users should default to.

Custom Branding

Under Settings, Global Settings / Branding you can change the Instance name and use custom css to change the branding, including default logotypes.

File and Folder Operations

The standard file dialog shows you the location you are, the files and folders available and allows for folder and file operations. On the left you see the two options to create a new folder or file at the location you are.

Once you have made a selection the top right bar shows you all available options. If you hover your mouse over them the text will tell you exactly what they are.

Among the options are Edit, Copy, Move, Delete, Download and Upload. This is what allows you to interact with your folder and file collection.


For the Sharing to work, File Browser needs to be reachable and administrated via a publicly reachable name like

Test the link you created in an incognito window of your browser.

The download link will show up like in the example above. It allows to download or open the file.

Most modern mobile devices detect the QR-Code and allow direct interaction.

Special Thanks

To our fantastic Discord community and our Admins Sycotix and Hawksy for their input and documentation (as always).

Final Words

We hope you enjoyed this guide. It was conceptualized, written, and implemented by our Admin DiscDuck.

Support Us

Our work sometimes takes months to research and develop. If you want to help support us please consider:

Thank you for being part of our community!

Last updated