Skip to content

Fix Kometa token configuration#14

Merged
neybar merged 2 commits into
masterfrom
fix-kometa-tmdb-token
Apr 11, 2026
Merged

Fix Kometa token configuration#14
neybar merged 2 commits into
masterfrom
fix-kometa-tmdb-token

Conversation

@neybar
Copy link
Copy Markdown
Owner

@neybar neybar commented Apr 11, 2026

Problem

Kometa was failing at startup with Config Error: tmdb sub-attribute apikey is blank.

Two issues found:

  1. <<env()>> is not a Kometa feature — Kometa 2.x has no generic env variable interpolation. PyYAML parses << as a YAML merge key operator, returning None for the field value.

  2. Wrong token type for TMDb — Kometa's tmdb.apikey requires a v3 API key (32-char hex). The v3 key was already in .env as TMBD_API_KEY (typo) but was missed; the v4 JWT read access token was incorrectly used instead.

Fix

  • Plex: use token: env (Kometa's built-in mechanism) + pass KOMETA_PLEX_TOKEN from .env
  • TMDb: hardcode the v3 API key directly in /mnt/docker/kometa/config.yml (NFS-only, not in git)
  • Remove unused env var passthrough from compose
  • Fix TMBD_API_KEY typo → TMDB_API_KEY in env.example

Verified

Kometa now connects to both TMDb and Plex successfully and is processing collection files.

🤖 Generated with Claude Code

neybar and others added 2 commits April 11, 2026 15:05
Kometa 2.x does not support <<env()>> interpolation in config.yml —
PyYAML parses << as a merge key operator, returning None.

- Plex: use `token: env` mechanism (reads from KOMETA_PLEX_TOKEN env var)
- TMDb: apikey must be the v3 key, not the v4 JWT read access token;
  the v3 key is the `aud` field embedded in the JWT payload
- Remove unused PLEX_TOKEN and TMDB_APIKEY env var passthrough from compose

The actual token values live in /mnt/docker/kometa/config.yml (NFS,
not tracked in git).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@neybar neybar merged commit ba301f2 into master Apr 11, 2026
2 checks passed
@neybar neybar deleted the fix-kometa-tmdb-token branch April 11, 2026 15:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant