Installation
Windows
Run Fliks as a native Windows system-tray app, with hardware transcoding and no separate dependencies to install.
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
- 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. - Hardware transcoding is auto-detected, in this order: QSV > AMF > NVENC > CPU. NVENC needs
an NVIDIA driver
570or 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.
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:
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.