Configuration

Pelagica can be configured through the web interface. If you are an admin, you can configure pelagica by clicking the “Pelagica Config” button in the user menu in the top right corner of the page. This will open the configuration page, where you can set home screen rows and other settings.

Jellyfin plugin requirement

Configuration (home screen sections, item page settings, branding, links, and so on) is stored by the Pelagica plugin directly on your Jellyfin server, rather than locally in each user’s browser. This means every user connecting to that server through Pelagica sees the same configuration.

If the plugin isn’t installed yet, opening the Pelagica Config page as an admin will show a prompt to install it instead of the usual settings. Click Install Plugin and Pelagica installs it automatically.

Manual plugin installation

If you’d rather install it manually (or the automatic install doesn’t work for your setup), add the plugin repository yourself from the Jellyfin dashboard:

1. In Jellyfin, go to Dashboard → Plugins → Repositories.
2. Add a repository with this URL: https://raw.githubusercontent.com/PelagicaApp/jellyfin-plugin/main/manifest.json
3. Go to the Catalog tab, find Pelagica under General, and install it.
4. Restart Jellyfin when prompted.

See the jellyfin-plugin repository for more details, including how to install it from a downloaded release zip.

Forcing a Jellyfin instance

If you want to force Pelagica to connect to a specific Jellyfin instance, you can set the SERVER_ADDRESS environment variable when starting the container. For example:

docker run -d \
    --name pelagica \
    -p 8080:80 \
    -v /path/to/config:/config \
    -e SERVER_ADDRESS=http://your-jellyfin-server:8096 \
    --restart unless-stopped \
    kartoffelchipss/pelagica:latest