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

Run FileBrowser Quantum v2.0.x (stable) natively on Linux using the binary releases.

Download

  1. Go to releases page
  2. Download the appropriate beta binary:
    • linux-amd64-filebrowser (64-bit)
    • linux-arm64-filebrowser (64-bit)
    • linux-armv6-filebrowser (32-bit)
    • linux-armv7-filebrowser (32-bit)
    • linux-riscv64-filebrowser (64-bit RISC-V, v2.0.x and later)

Make Executable

BASH 
1

chmod +x linux-amd64-filebrowser

Optional: Install FFmpeg

BASH 
1
2
3
4
5
6
7
8

# Debian/Ubuntu
sudo apt install ffmpeg

# RHEL/CentOS/Fedora
sudo dnf install ffmpeg

# Arch Linux
sudo pacman -S ffmpeg

Create Configuration

Interactive setup:

BASH 
1

./linux-amd64-filebrowser setup

Or create config.yaml:

YAML 
1
2
3
4
5
6
7
8
9

http:
  port: 80
server:
  sources:
    - path: "/home/user/files" # Do not use a root "/" directory or include the "/var" folder
      config:
        defaultEnabled: true
auth:
  adminUsername: admin

v2.0.0 and later read the listen port from http.port. A server.port key is rejected at startup.

Run FileBrowser

BASH 
1

./linux-amd64-filebrowser -c config.yaml

Access at http://localhost:80.

On v2.x (v2.0.0+), if adminPassword is unset or left as admin, a random admin password is generated, logged once, and a password reset is required on first login. Any other value of auth.methods.password.adminPassword or auth.adminPassword is used as-is.

Run as Systemd Service

Step 1: Move Binary

BASH 
1
2

sudo mv linux-amd64-filebrowser /usr/local/bin/filebrowser
sudo chmod +x /usr/local/bin/filebrowser

Step 2: Create Service File

Create /etc/systemd/system/filebrowser.service:

INI 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

[Unit]
Description=FileBrowser Quantum
After=network.target

[Service]
Type=simple
User=filebrowser
WorkingDirectory=/opt/filebrowser
ExecStart=/usr/local/bin/filebrowser -c /opt/filebrowser/config.yaml
Restart=on-failure

[Install]
WantedBy=multi-user.target

Step 3: Create User and Directory

BASH 
1
2
3

sudo useradd -r -s /bin/false filebrowser
sudo mkdir -p /opt/filebrowser
sudo chown filebrowser:filebrowser /opt/filebrowser

Step 4: Move Config

BASH 
1
2

sudo mv config.yaml /opt/filebrowser/
sudo chown filebrowser:filebrowser /opt/filebrowser/config.yaml

Step 5: Enable and Start

BASH 
1
2
3

sudo systemctl daemon-reload
sudo systemctl enable filebrowser
sudo systemctl start filebrowser

Check Status

BASH 
1

sudo systemctl status filebrowser

Next Steps