Installation
macOS
Run Fliks as a native macOS menu-bar app, with VideoToolbox hardware acceleration and no separate dependencies to install.
Download the .dmg from the latest release, drag Fliks Server to Applications, and Fliks opens at http://localhost:4848. Apple Silicon and macOS 13 or newer.
What the app bundles
A lightweight menu-bar app that runs the Fliks server natively on macOS, with hardware transcoding through Apple's VideoToolbox, auto-detected at startup. It bundles PostgreSQL, FFmpeg, the streaming engine and the server: there is nothing else to install. Requires Apple Silicon and macOS 13 (Ventura) or newer.
Install the macOS app#
Download the Fliks-Server-<version>-arm64.dmg asset from the
latest release, open it and drag Fliks Server
to Applications. A film icon appears in the menu bar once it runs. Official builds are signed
with a Developer ID certificate and notarized, so Gatekeeper opens them without a warning.
What happens on first launch
- PostgreSQL 18 initializes on first run and starts on port
5433. - The engine listens on port
4848and starts the server behind it. - On the very first launch only, your browser opens
http://localhost:4848. - VideoToolbox hardware acceleration is auto-detected.
Menu bar actions
| Action | What it does |
|---|---|
| Open Fliks | Opens the web UI in your default browser. |
| Start at Login | Toggles auto-start on macOS login. |
| Restart Server | Stops and restarts PostgreSQL and the server. |
| View Logs... | Opens the log directory in Finder. |
| Check for Updates... | Asks for a newer release and, if there is one, installs it in place. See Updating. |
| Quit Fliks | Gracefully shuts down every process. |
Where the data lives
| Path | Contents |
|---|---|
~/Library/Application Support/Fliks Server/postgresql/ |
The database cluster. |
~/Library/Application Support/Fliks Server/conf/ |
The auto-generated JWT secret and engine token. |
~/Library/Application Support/Fliks Server/data/ |
The server's working directory: artwork, avatars, backups. |
~/Library/Application Support/Fliks Server/logs/ |
Server and PostgreSQL logs. |
/tmp/transcode/ |
The HLS transcode cache, ephemeral. |
On versions up to 4.1.x, in-app backups need pg_dump, which the app
doesn't bundle. They only work if a PostgreSQL client of the same major version (or newer) is
installed in /opt/homebrew/bin or /usr/local/bin.
Wipe everything and start over
To wipe everything and start over, quit Fliks first, then in Terminal:
rm -rf ~/Library/Application\ Support/Fliks\ ServerFirst run#
Your browser opens http://localhost:4848 on the first launch. Continue with the
Quick start from step 2; the library can point at any folder on disk.