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

Run FileBrowser Quantum v1.5.x (stable) natively on Linux using the binary releases.

Download

  1. Go to releases page
  2. Download the appropriate stable binary:
    • linux-amd64-filebrowser (64-bit)
    • linux-arm64-filebrowser (64-bit)
    • linux-armv6-filebrowser (32-bit)
    • linux-armv7-filebrowser (32-bit)

Make Executable

BASH 
1

chmod +x filebrowser-linux-amd64

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

./filebrowser-linux-amd64 setup

Or create config.yaml:

YAML 
1
2
3
4
5
6
7
8

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

Run FileBrowser

BASH 
1

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

Access at http://localhost:80

Run as Systemd Service

Step 1: Move Binary

BASH 
1
2

sudo mv filebrowser-linux-amd64 /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