jellomator/README.md

Jellomator

Dark dashboard for Arr* services and custom links.

Features

• First-run admin setup
• Cookie-based admin auth
• Public dashboard with search/filter
• Dedicated protected admin page at /admin
• Link CRUD backed by MariaDB
• Icon blobs stored in the database
• Single-container deployment
• Admin-managed service links

Local Dev

npm install
npm run dev

Backend runs on http://localhost:6363.

Open /admin for the protected management page.

Docker

docker compose up --build

The app expects a MariaDB instance configured through environment variables.

Session and Cookie Env Vars

• SESSION_TTL_SECONDS (default: 86400)
• SESSION_COOKIE_SECURE (default: false, set true in production HTTPS)

Gitea CI/CD

Add these secrets in Gitea:

• REGISTRY
• REGISTRY_USERNAME
• REGISTRY_PASSWORD
• IMAGE_NAME

The workflow builds and pushes latest plus the commit SHA tag.