Published: October 8, 2025
Last updated: July 24, 2026
Suggest an edit

The preferred configuration method is to use config.yaml. However, environment variables are available for secrets, config override, and developer purposes.

Available Variables

VariableConfig EquivalentDescription
FILEBROWSER_CONFIG-Config file path when no CLI argument provided
FILEBROWSER_DATABASEserver.databasev1.x.x only. BoltDB database file path (e.g. database.db). Removed in v2.0.0 — use FILEBROWSER_DATABASE_PATH instead.
FILEBROWSER_DATABASE_PATHserver.database.pathv2.0.0+. SQLite database file path (default: filebrowser.sqlite)
FILEBROWSER_ADMIN_PASSWORDauth.adminPasswordAdmin password
FILEBROWSER_ONLYOFFICE_SECRETintegrations.office.secretOnlyOffice JWT secret
FILEBROWSER_FFMPEG_PATHintegrations.media.ffmpegPathPath to FFmpeg binaries
FILEBROWSER_OIDC_CLIENT_IDauth.methods.oidc.clientIdOIDC client ID
FILEBROWSER_OIDC_CLIENT_SECRETauth.methods.oidc.clientSecretOIDC client secret
FILEBROWSER_JWT_TOKEN_SECRETauth.keyJWT signing key
FILEBROWSER_TOTP_SECRETauth.totpSecretTOTP encryption secret
FILEBROWSER_RECAPTCHA_SECRETauth.methods.password.recaptcha.secretreCAPTCHA secret key
FILEBROWSER_DISABLE_AUTOMATIC_BACKUPN/ADisable automatic backup

Usage Example

Docker Compose:

YAML 
1
2
3
4
5
6
7
8

services:
  filebrowser:
    image: gtstef/filebrowser:stable
    environment:
      - FILEBROWSER_ADMIN_PASSWORD=secure-password
      - FILEBROWSER_ONLYOFFICE_SECRET=office-secret
    volumes:
      - ./config.yaml:/home/filebrowser/config.yaml

CLI:

BASH 
1
2
3

export FILEBROWSER_ADMIN_PASSWORD="secure-password"
export FILEBROWSER_JWT_TOKEN_SECRET="jwt-secret"
./filebrowser -c config.yaml

Next Steps