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

Run FileBrowser Quantum v1.5.x (stable) natively on macOS.

Download

  1. Go to releases page
  2. Download the stable filebrowser-darwin-amd64 (Intel) or filebrowser-darwin-arm64 (Apple Silicon) release
  3. Save to a folder

Enable Permissions

Step 1: Make Executable

BASH 
1

chmod +x filebrowser-darwin-arm64

Step 2: Allow in Security Settings

On first run, macOS will block the app:

  1. Try to run: ./filebrowser-darwin-arm64
  2. Go to System Preferences → Security & Privacy
  3. Click Allow for FileBrowser

Optional: Install FFmpeg

BASH 
1

brew install ffmpeg

Create Configuration

BASH 
1

./filebrowser-darwin-arm64 setup

Or create config.yaml:

YAML 
1
2
3
4
5
6
7
8

server:
  port: 80
  sources:
    - path: "/Users/yourname/Documents"
      config:
        defaultEnabled: true
auth:
  adminUsername: admin

Run FileBrowser

BASH 
1

./filebrowser-darwin-arm64 -c config.yaml

Access at http://localhost:80

Run as Service (launchd)

Create /Library/LaunchDaemons/com.filebrowser.plist:

XML 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.filebrowser</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/filebrowser</string>
        <string>-c</string>
        <string>/usr/local/etc/filebrowser/config.yaml</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>

Load service:

BASH 
1

sudo launchctl load /Library/LaunchDaemons/com.filebrowser.plist

Next Steps