Kometa Utilities

A single repo for Kometa support utilities.

One repo, one deployment.

Docker Workflow

This repository publishes Docker images for its locally maintained utility services:

• ghcr.io/kometa-team/anidb-mirror
• ghcr.io/kometa-team/plex-oauth
• ghcr.io/kometa-team/trakt-oauth
• ghcr.io/kometa-team/mal-oauth
• ghcr.io/kometa-team/simkl-oauth
• ghcr.io/kometa-team/simkl-service
• ghcr.io/kometa-team/imdb-service

The base docker-compose.yml uses those published GHCR images.

For local development, docker-compose.override.yml is automatically picked up by Docker Compose and switches those same services back to local build: contexts. In practice that means:

• server/production usage pulls published images by default
• local development builds from source by default

If you want to force a local rebuild, use:

docker compose up -d --build

For imdb-service, the Playwright/browser layer now lives in a separate base image so code-only updates stay small. To rebuild both the IMDb base image and the app image locally in one step, use:

./imdb-service/build-local.sh

Optional overrides:

BASE_IMAGE=ghcr.io/kometa-team/imdb-service-base:dev \
APP_IMAGE=ghcr.io/kometa-team/imdb-service:dev \
./imdb-service/build-local.sh

GitHub Actions

The repository includes two Docker-related GitHub Actions workflows:

• Pull requests to main: build the utility images for validation only
• Pushes to main: build and publish the utility images to GHCR

Relevant workflow files:

• .github/workflows/docker-pr-build.yml
• .github/workflows/docker-build.yml
• .github/workflows/deploy.yml

This lets contributors verify Docker changes in PRs while keeping image publishing limited to the main branch.

Deployment Workflow

The repository also includes a deployment workflow that connects to the remote server over SSH after the Docker Builds workflow completes successfully on main.

The workflow:

• pulls the latest Git branch on the server
• runs docker compose pull
• runs docker compose up -d
• prunes dangling Docker images

Required GitHub Actions secrets:

• DEPLOY_HOST
• DEPLOY_USER
• DEPLOY_SSH_KEY
• DEPLOY_PROJECT_DIR

Optional secrets:

• DEPLOY_PORT (defaults to 22)
• DEPLOY_BRANCH (defaults to main)