Feat: Filebrowser -> added to my deployment howto

[daemon31337]

Update 5/5/25: Fixed .env and compose file to only use the .env for environment variables. Removed hostname in local .env as that is now set in the main .env in /opt/docker/apps

Filebrowser - something I use as a simple method to upload and download files, it also automatically compresses large sets of files or directories. I find it useful to backup and move files to/from my personal system and servers at times + even edit files. Adding so others may follow if they want to add this or other containers they may want to run (caution: if you dont know how this environment is setup by Viren, dont mod it until you do). Also putting here to add if you would like viren but you likely use scp command line:

1. create directory structure
   ubuntu@daemonrealm:/opt/docker/apps$ mkdir filebrowser

in data too:
ubuntu@daemonrealm:/opt/docker/data$ mkdir filebrowser

2. create database file before starting the container or else it crash loops and creates a directory not a file on local system
   ubuntu@daemonrealm:/opt/docker/data/filebrowser$ touch database.db

3. Navigate back to your /opt/docker/apps/filebrowser. Create compose.yaml then populate:

services:
  filebrowser:
    image: filebrowser/filebrowser:latest
    container_name: filebrowser
    restart: unless-stopped
    user: "${PUID}:${PGID}"
    expose:
      - 9090
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.filebrowser.rule=Host(`${FILEBROWSER_HOSTNAME?}`)"
      - "traefik.http.routers.filebrowser.entrypoints=websecure"
      - "traefik.http.routers.filebrowser.tls.certresolver=letsencrypt"
      - "traefik.http.services.filebrowser.loadbalancer.server.port=9090"
      - "traefik.http.routers.filebrowser.middlewares=authelia@docker"
    volumes:
      - "${DOCKER_DATA_DIR}/filebrowser/database.db:/database.db"
      - "${FILEBROWSER_HOME}:/srv"
    env_file:
      - .env
    profiles:
      - filebrowser
      - all

4. Then create .env and populate:

# Filebrowser is a simple lightweight web enable file management utility. Use 'openssl rand -base64 32' to generatre the key
# Set FILEBROWSER_HOME to the home files directory that filebrowser will use
# Remember to change the default admin:admin password on first login. This container is protected by Authelia
FB_ENCRYPTION_KEY=9qu1nTeFEfcCN2UCv1zrWG0pjcRfmARG4pzo4L7Aa9o=
FILEBROWSER_HOME=/opt/
FB_PORT=9090

5. Navigate to /opt/docker/apps modify compose.yaml and add under include:

- filebrowser/compose.yaml

6. same location now finally add your profile to run in your profiles section in .env. I add and remove profiles as I configure them/need them up and running + the default one. You can remove the profiles: section in the compose above if you want to run it as default (which I will be doing).

# TL;DR, each folder in the apps directory is a profile.
# And additional profiles are as follows: stremio, indexers, debrid_media_server
# A final profile - all - is provided that includes every service in the template.
COMPOSE_PROFILES="speedtest-tracker, librespeed, aiostreams, warp, mediaflow-proxy, filebrowser"

Also add the DNS name under:

# These values are the subdomains that Traefik will use to route traffic to the services. 
# You can modify these values to suit your needs, but ensure that they are unique and do not conflict with other services.

FILEBROWSER_HOSTNAME=filebrowser.${DOMAIN}

7. last as I use Honey as my main dashboard - update it to include filebrowser. modify /opt/docker/data/honey/config.json

Under services add:

 {
			"name": "Filebrowser",
			"desc": "File management and explorer.",
			"href": "https:/YOUR_FILEBROWSER_DOMAIN",
			"icon": "https://raw.githubusercontent.com/filebrowser/filebrowser/refs/heads/master/frontend/public/img/icons/favicon.ico"
		},

8. Restart docker and you're all set, dont forget to change the default login

[nhyyebo]

+1 just to make viren do more.

[daemon31337]

^^^ really confused on that above comment. This is not an issue I’m reporting. Just a feature if you decide you want, you can add to your own environment. I believe Viren uses SCP so file browser isn’t needed.

This also walks you thru how to add other packages (high level) to the distributed docker compose setup in the directory structure and .env/compose files that Viren uses in his template.

[nhyyebo]

my bad.

[campsite2904]

question on step 2, should the database.db be created on "/docker/data" or inside the filebrowser folder "/docker/data/filebrowser" ?

[daemon31337]

the compose has

volumes:
- "${DOCKER_DATA_DIR}/filebrowser/database.db:/database.db"

so it would be in /opt/docker/data/filebrowser

I have a type-o above, touch the database.db file in /opt/docker/data/filebrowser. Ill correct

[moquette]

Thanks for this 👍🏼

[derrickb]

Not sure if the convention used to be different, but step 5 should now be:

Navigate to /opt/docker modify compose.yaml and add under include:
- apps/filebrowser/compose.yaml

[daemon31337]

Not sure if the convention used to be different, but step 5 should now be:

Navigate to /opt/docker modify compose.yaml and add under include:
- apps/filebrowser/compose.yaml

Will modify thanks. Viren changed the template format in late 2025 to use apps/appname/compose.yaml due to his top level compose file used to be in apps dir which would pick up just the . now it’s in root of docker/ so needs the apps/ added.