JellyGlance documentation

Learn how to install JellyGlance, connect your Jellyfin server, and manage your media stack. JellyGlance runs alongside Jellyfin and brings sessions, users, requests, downloads, and server health into one dashboard.

Live documentation ↗ JellyGlance website ↗ Application repo ↗ Documentation repo ↗

Docker

Jellyfin

PostgreSQL

Sonarr

Radarr

Nginx

Homarr

Discord

Get started

If this is your first installation, follow these steps:

1. Install JellyGlance with Docker Compose and configure your database and application secrets.
2. Complete first setup to connect Jellyfin, choose a login method, and run the initial sync.
3. Connect integrations for requests, downloads, calendars, and notifications.

Before you begin

You need a running Jellyfin server, a Jellyfin API key, and Docker with Compose v2. PostgreSQL is included in the example Compose stack.

Installation and configuration

Guide	What you’ll find
Installation	Requirements, Docker setup, and the first-run wizard
Docker	Environment values, persistent storage, and updates
Unraid and TrueNAS	Deploying the stack on your NAS
Reverse proxy	HTTPS access with Nginx Proxy Manager, Caddy, Nginx, or Traefik
Configuration reference	Environment variables, defaults, and first-run bootstrap
Authentication	Local accounts, Quick Connect, OIDC, and roles
Integrations	Jellyfin, Seerr, Arr apps, download clients, and notifications

Using JellyGlance

Guide	What you’ll find
Dashboard and kiosk	Annotated dashboard, layouts, themes, and wall displays
Notifications	Discord, Gotify, ntfy, Telegram, and Pushover
Screenshots and interface guide	Setup screens, dashboard pages, and settings
Homepage and Homarr widgets	API authentication, endpoints, and downloadable widget configurations
Backup and restore	Exports, retention, recovery, and moving servers
Updates and recovery	Stable/beta channels, update checks, and recovery
Background tasks	Task purpose, refresh selection, and failure diagnosis
API cookbook	Read-only requests and example JSON responses
Architecture	How the web app, API, database, and integrations fit together

Troubleshooting

Use the troubleshooting hub for step-by-step diagnosis and log collection.

The frequently asked questions cover common installation and connection problems:

• Jellyfin URL or API key will not validate
• First sync is stuck or the dashboard looks empty
• Requests, Downloads, or Invites are missing
• Homepage or Homarr returns 403
• Reverse proxy configuration

For further help, ask in Discord or open an issue on GitHub.

Documentation correction or suggestion? Open a documentation issue.