Sofa — Self-hosted movie & TV tracker

Sofa is a self-hosted movie and TV tracker for nerds. Track what you've watched, discover what's next, and plug your data into your existing home media stack. All without anything leaving your homelab. 🍿

• Track episode-level progress for TV series and pick shows back up from a dedicated "Continue Watching" view
• Mark movies as watched to discover more like them
• Rate titles, browse cast and crew, and get recommendations based on what you are already tracking
• Search TMDB and explore trending movies and shows without leaving your own instance
• Show streaming availability from TMDB's US provider data
• Automatically log completed watches from Plex, Jellyfin, or Emby webhooks
• Import existing watch history, ratings, and watchlists from Trakt, Simkl, or Letterboxd
• Expose your watchlist as import lists for Sonarr and Radarr
• Runs on SQLite with local image caching, built-in backups, and no external database requirement
• Supports local accounts or OIDC SSO for private instances

A minimal docker-compose.yml is provided in this repo. For most setups, the shortest path is:

1. Copy the example environment file:

cp .env.example .env

2. Fill in the required values:

TMDB_API_READ_ACCESS_TOKEN=your_tmdb_read_access_token
BETTER_AUTH_SECRET=generate_a_long_random_secret
BETTER_AUTH_URL=http://localhost:3000

3. Start the container:

docker compose up -d

4. Open http://localhost:3000 and create the first account. The first account becomes the admin automatically, and registration closes after that by default.

The included Compose file uses ghcr.io/jakejarvis/sofa:edge. If you prefer to pin releases, switch to a published version tag like ghcr.io/jakejarvis/sofa:<version> or use the matching jakejarvis/sofa:<version> image on Docker Hub. Multi-arch images are published for linux/amd64 and linux/arm64.

If you prefer to deploy Sofa to the cloud, there are several great options. All you'll need is the ability to run Docker containers and mount some form of persistent storage volume to /data within the container.

Sofa uses TMDB for metadata, posters, cast, recommendations, and streaming availability. You need a TMDB API Read Access Token before the app can do anything useful.

Create one here:

• TMDB signup
• API settings

BETTER_AUTH_SECRET should be a long random string. To generate one:

npx @better-auth/cli@latest secret
# or
openssl rand -base64 32

Set BETTER_AUTH_URL to the real external URL of your instance. This especially matters for login flows and OIDC callbacks behind a reverse proxy (like nginx or Traefik).

See .env.example for the full list.

Sofa ships with two kinds of integrations (for now): incoming watch activity and outgoing import lists.

• Plex: logs completed watches through a webhook URL generated in Sofa. Requires an active Plex Pass license.
• Jellyfin: works through the Jellyfin Webhook plugin.
• Emby: logs completed watches through webhooks. Requires Emby Server 4.7.9+ and an Emby Premiere subscription.

These integrations are user-specific, so each user can connect their own media server account and watch history.

• Sonarr: expose your Sofa TV watchlist as a custom import list
• Radarr: expose your Sofa movie watchlist as a custom import list

For local development:

bun install
cp .env.example .env
bun run dev

Useful commands:

• bun run test
• bun run lint
• bun run format
• bun run check-types
• cd packages/db && bun run db:generate
• cd packages/db && bun run db:migrate

This product uses the TMDB API but is not endorsed or certified by TMDB.

MIT