Menu
ContentsFirst-time setup

  1. Getting started

    1. What Kryspal Media is
    2. System requirements
    3. Install with Docker
    4. First-time setup
    5. Upgrade and back up

  2. Libraries

    1. Create and manage libraries
    2. File and folder naming
    3. Flexible file layout
    4. Metadata and NFO
    5. Tags
    6. Images
    7. strm and cloud drives
    8. StrmTool settings
    9. Subtitles
    10. Intro and outro
    11. Search tips
    12. Actors and people
    13. Duplicate videos

  3. Playback

    1. Web player
    2. Third-party players
    3. Remote access

  4. Members and devices

    1. Members
    2. Parental controls
    3. Devices and simultaneous streams

  5. Plugins

    1. Plugin center
    2. Plugins
    3. Third-party plugins

  6. Move from another server

    1. Move from Emby
    2. Move from Jellyfin

  7. Licenses and plans

    1. Compare plans
    2. PRO features in detail
    3. MAX features in detail
    4. Buy, activate and move a license
    5. Offline grace and expiry

  8. Troubleshooting

    1. Logs and reporting a problem

First-time setup

The first time you open Kryspal Media, a setup wizard walks you through language, the administrator account, the server name, which players to support, metadata, and how to start. This page follows those steps and ends with your first library.

On this page
  1. Open the wizard
  2. The steps
  3. Add your first library
  4. Next

Open the wizard#

Open http://<host>:5797/web/ in a browser. The wizard shows your progress at the top. Each step has Next and Back. Once the administrator account is created, the wizard remembers that setup is not finished. If you close the page, it opens again at the Server step.

If the server already has an administrator (for example you set the first administrator's password when you installed it), the wizard says so and offers Go to sign in. Sign in and continue at "Add your first library" below.

The steps#

  1. Language. Choose the interface language. It applies right away. The administrator account and the server default use it too, and you can change both later.
  2. Admin. Create the administrator account. Enter a name, a password and the password again, then press Create account. This account manages libraries, members and server settings, and you can also sign in with it on players. Keep the password somewhere safe. After too many failed attempts you have to wait a few seconds.
  3. Server. Give the server a name (up to 64 characters). Players list the server by this name, and the web player shows it. You can press Skip and change it later in server settings.
  4. Third-party player compatibility. Choose which third-party players can connect. Whichever you choose, Kryspal's own web player and apps always work. You can change this later under System settings.
    • 3rd-party players for Emby (recommended): Infuse, SenPlayer and others that use the Emby protocol.
    • 3rd-party players for Jellyfin: players that use the Jellyfin protocol.
    • Off: third-party players get no answer.
  5. Metadata. Posters, plots and cast come from TMDB, which needs a free read token. Follow the three steps on the page: sign in to TMDB, request an API key for personal use, then copy the API Read Access Token and paste it under Read access token. Press Check and save. Press Later to skip it; until a metadata source is set up, titles only show their file names.
  6. Start. Choose how to begin.
    • Fresh setup: start by adding your first library.
    • Migrate from Emby / Jellyfin: connect to an existing server and import libraries, members and watch history. You choose Emby or Jellyfin on the migration page. This server needs access to the source server's media folders.

Add your first library#

For a fresh setup:

  1. Open Libraries in the sidebar and press Add library. On the Overview page, Add your first library does the same.
  2. Choose the type and enter the folder path as the container sees it, for example /media/Movies. This is the path inside the container where you mounted your media folder, not the path on the host.
  3. Save. The server scans the folder, and items appear as the scan runs.

For naming rules that help recognition, see File and folder naming. For all library options, see Create and manage libraries.

Next#

  • Add members, so family can sign in on their own players.
  • Connect your player to http://<host>:5797 with a member account.
  • With PRO, turn on automatic backups.