Administration

FAQ

Honest answers to the questions self-hosters ask most often.

In short

Short answers to the questions self-hosters ask most, each with the fix and a link to the full page. Looking for a symptom (nothing shows up, no subtitles, buffering)? The headings below are written the way you would search for them.

Setup#

Do I need Docker?#

No. Docker is recommended, but native builds exist for Windows and macOS, and you can build it from source.

I forgot the admin password and it's my only admin account. What now?#

There is no "forgot password" flow. Another account with users.manage and settings.access can set you a new password in Settings > Users. A backup holds the same password, so it won't help.

With no other admin: write a new password hash into the database

On the Docker setup from Docker, open the database with docker compose exec postgres psql -U fliks -d fliks, then run this with your username and a temporary password. pgcrypto produces the bcrypt hash and the last line removes it again:

sql
CREATE EXTENSION IF NOT EXISTS pgcrypto;
UPDATE users SET "passwordHash" = crypt('temporary-password', gen_salt('bf', 12)), "requirePasswordChange" = true WHERE username = '<username>';
DROP EXTENSION pgcrypto;

Log in with the temporary password; Fliks asks you to pick a new one straight away.

Nothing shows up after I add a library. Is it broken?#

Check the container path and click Scan the folder on the library. Full checklist: My files don't show up.

My titles have no posters or descriptions#

Run Settings > System > Trigger a task > Metadata > Reload missing metadata. More: No posters or descriptions.

Subtitles are missing#

A fresh install has no provider: add one in Settings > Subtitle providers (how). More: Subtitles are missing.

Playback buffers or stutters#

Settings > Playback quality gives each stall a cause (Playback quality). More: The video keeps buffering.

Do I need quality profiles, auto-approval and the other download settings?#

Not to play files you already have. See Which areas you can ignore.

Where is the setting for X?#

See the map of the admin area or the first-day checklist.

Does Fliks need internet access to work?#

Only for metadata, the update check and plugin catalogues. Playback works on your network without it.

Playback and transcoding#

Why is Fliks transcoding instead of playing the file directly?#

The device cannot decode the file as is: Transcoding dashboard shows the reason. More: Fliks transcodes instead of playing the file directly.

My GPU isn't being used for transcoding#

See My GPU isn't used for transcoding and Hardware acceleration.

Does Fliks support 4K and HDR?#

Yes. Direct Play and Direct Stream pass HDR through; for a screen that can't show it, HDR10, HLG and Dolby Vision are tone-mapped to SDR. An HDR-preserving transcode needs HEVC on Intel QSV or NVIDIA NVENC, or AV1 on NVENC. See HDR and Dolby Vision.

Accounts and access#

Can I give someone access to only some of my libraries?#

Yes, per user, independent of the role: Users and permissions.

Can non-admin users request new content?#

Yes, if their role has requests.create (the default User role does). requests.manage or an auto-approval rule approves it.

License and project#

What license is Fliks under?#

AGPL-3.0-or-later: if you run a modified version and let others use it over a network, you owe them the modified source.

Is there a Nintendo Switch client?#

Yes, in beta, in a separate repository (switchfliks) that you build yourself as a homebrew .nro. It isn't part of the main release.

See also#

Edit this page on GitHub

Esc