Installation

Windows

Run Fliks as a native Windows system-tray app, with hardware transcoding and no separate dependencies to install.

In short

Download the installer from the latest release, run it (no administrator prompt), and Fliks opens at http://localhost:4848. It bundles everything it needs.

What the app bundles

A lightweight system-tray app that runs the Fliks server natively on Windows, with hardware transcoding through Intel QSV, AMD AMF or NVIDIA NVENC, auto-detected at startup. It bundles its own PostgreSQL, FFmpeg, streaming engine and server: there is nothing else to install. The tray app itself is a C#/.NET 8 WinForms application; the server underneath it is the same one as every other install method.

Install the Windows app#

Download the installer from the latest release (the Fliks-Server-<version>-Setup.exe asset) and run it. It needs 64-bit Windows 10 or 11. It installs per-user, with no administrator prompt, into %LOCALAPPDATA%\FliksServer.

If SmartScreen warns that the app is unrecognized, choose More info > Run anyway.

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. Hardware transcoding is auto-detected, in this order: QSV > AMF > NVENC > CPU. NVENC needs an NVIDIA driver 570 or newer; on an older driver it's skipped and NVIDIA hardware falls back to CPU. AMD runs a full GPU pipeline (D3D11 decode, scale, AMF encode) on the bundled FFmpeg.
Tray menu actions
Action What it does
Open Fliks Opens the web UI in your default browser.
Start at Login Toggles auto-start, stored in the per-user Run registry key.
Update to <version> Appears when a newer release exists: downloads it, stops the server and installs it. See Updating.
Restart Server Stops and restarts PostgreSQL and the server.
View Logs… Opens the log folder in Explorer.
Quit Fliks Gracefully shuts down every process.
Where the data lives
Path Contents
%LOCALAPPDATA%\Fliks Server\postgresql\ The database cluster.
%LOCALAPPDATA%\Fliks Server\conf\ The JWT secret, the engine token and tray-settings.json, which holds the web port (Port, default 4848) and the database port (PgPort, default 5433).
%LOCALAPPDATA%\Fliks Server\data\ The server's working directory: images, thumbnails, backups.
%LOCALAPPDATA%\Fliks Server\logs\ Server and PostgreSQL logs.
%LOCALAPPDATA%\Fliks Server\transcode\ The HLS transcode cache, ephemeral.

Uninstalling the app through Windows' own uninstaller leaves this data in place; the app itself is removed from %LOCALAPPDATA%\FliksServer.

Note

On versions up to 4.1.x, in-app backups need pg_dump, which the app doesn't put on the server's PATH. They only work if a PostgreSQL client of the same major version (or newer) is installed and on the system PATH.

Wipe everything and start over

To wipe everything and start over, close Fliks first, then in PowerShell:

powershell
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\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