Skip to main content
The first time you open Kernel (or any time no admin account exists), it opens straight into the setup wizard instead of the normal sign-in screen.
1

Database

Choose SQLite (default, no setup needed) or connect an existing Postgres, MySQL, or MSSQL server. Use Test Connection before continuing; this step writes data/db.json and restarts the server, so the wizard resumes automatically from where you left off.
2

Server

Basic server settings.
3

Admin account

Create the first user. This account is an admin and can create more users later from Settings. The token issued here is short-lived (24 hours); after finishing setup you’ll sign in normally, which issues a regular session token.
4

Preferences

General server preferences.
5

Live TV source (optional)

Add an Xtream Codes, M3U, or HDHomeRun source. You can skip this and add it later from Settings.
6

EPG / channel mapping (optional)

Map imported channels to EPG guide data.
7

Library (optional)

Point Kernel at a folder of movies or TV shows to start your first library scan.
8

Third-party API keys

Add a TMDB API key (and any other configured providers) for metadata enrichment.
9

Review & finish

Confirm your choices. Finishing this step marks setup complete; the wizard won’t reappear unless the admin account is somehow removed.
Everything optional here (Live TV source, EPG mapping, Library) can be added or changed later from the admin Settings pages; the wizard isn’t your only chance to configure them.