Published: October 8, 2025
Last updated: October 4, 2026

Run FileBrowser Quantum v2.0.x (stable) natively on Windows.

Download

  1. Go to releases page
  2. Download the beta Windows asset filebrowser.exe
  3. Save to a folder (e.g., C:\FileBrowser\)

Optional: Install FFmpeg

For video preview support, install FFmpeg.

Create Configuration

Interactive setup:

BASH
1
.\filebrowser.exe setup

Or Create config.yaml in the same folder:

YAML
1
2
3
4
5
6
7
8
9
http:
  port: 80
server:
  sources:
    - path: "C:\\Users\\YourName\\Documents"
      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.

Or generate interactively:

CMD
1
.\filebrowser.exe setup

Run FileBrowser

CMD
1
.\filebrowser.exe -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.

Troubleshooting

For common issues and solutions, see the Troubleshooting guide.

Next Steps