Installation

macOS

Run Fliks as a native macOS menu-bar app, with VideoToolbox hardware acceleration and no separate dependencies to install.

In short

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
  1. PostgreSQL 18 initializes on first run and starts on port 5433.
  2. The engine listens on port 4848 and starts the server behind it.
  3. On the very first launch only, your browser opens http://localhost:4848.
  4. 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.
Note

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:

bash
rm -rf ~/Library/Application\ Support/Fliks\ Server

First 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.

See also#

Hardware acceleration and Updating.

Edit this page on GitHub

Esc