Skip to content
Odeion

Setup Wizard

The first time you open your server’s URL, Odeion presents a setup wizard. The server is not usable until it completes. The first screen offers two paths: a fresh setup, or restoring a backup from a previous installation.

Fresh Setup

Section titled “Fresh Setup”

  1. License. Enter your license key (format XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX). Keys are issued at billing.odeion.app.

  2. Account. Create the first user. This account is an admin; everyone else joins later by invite.

  3. Server. Set the base URL (your public HTTPS address, used for app connections and generated links) and confirm the storage paths. FFmpeg/FFprobe locations and the cache directories are pre-filled from a system scan; change them only if you want different locations.

  4. System. Configure transcoding for your hardware: the transcode cache size cap, transcoding pools detected from your GPU (enable and set concurrent slots), and media processing toggles such as subtitle extraction. The defaults come from a hardware scan and are sensible to accept.

  5. Metadata. Choose metadata providers. Odeion Meta is enabled by default and needs no API key; TMDB and TheTVDB can be enabled if you bring your own keys. Providers can be changed later in Admin > Settings > Metadata.

  6. Libraries. Add your first media libraries: a name, a type (movies, series, anime), and the path inside the container (the /media/... mounts from your compose file). You can also skip this and add libraries later.

After the last step the server starts scanning your libraries, and you land in the web app signed in as your new admin.

Restoring from Backup

Section titled “Restoring from Backup”

Choosing restore instead asks for a backup archive, shows what the archive contains, and lets you pick a restore mode before applying it. A full restore brings back users, libraries, settings, and watch history, and the remaining wizard steps are skipped. See Backups for what each mode covers.

After Setup

Section titled “After Setup”

Everything configured in the wizard can be changed later under Admin > Settings. If you haven’t already, set up a reverse proxy with HTTPS, which is required for mobile and TV app connections, then check the security hardening checklist.