sayem314/lunarr repository overview

⁠Lunarr

Lunarr is a self-hosted media server for movie and TV libraries on local disks, SFTP, or WebDAV. It scans your files, matches them with TMDb metadata, and plays them with direct streaming or on-the-fly HLS transcoding. Chromecast and AirPlay are supported for remote playback. Mobile and TV apps are available on Google Play⁠ and the App Store⁠.

⁠Features

• Local, SFTP, and WebDAV libraries with TMDb metadata, continue watching, recommendations, and per-user watchlists
• Direct play or on-the-fly HLS transcoding with optional hardware acceleration (VAAPI, QSV)
• Sidecar subtitles (.vtt and .srt), intro/recap/credits skip markers via TheIntroDB
• Search, Continue/Discover/Browse hubs, scheduled rescans, and live filesystem watching
• Admin console for users, roles, libraries, sharing, jobs, and settings
• Image includes system FFmpeg with hardware acceleration drivers (Mesa VA-API on all architectures; Intel VAAPI/QSV on amd64)

⁠Quick Start

docker run -d \
  --name lunarr \
  --restart unless-stopped \
  -p 3000:3000 \
  -e AUTH_SECRET=replace-with-a-random-secret-at-least-32-chars \
  -e ORIGIN=http://127.0.0.1:3000 \
  -v lunarr-data:/data \
  -v /mnt/media:/media:ro \
  sayem314/lunarr:latest

Open http://127.0.0.1:3000, create the first admin account, add a movie or TV library, then run a scan from Libraries. For mounted local media, use the container path, such as /media.

⁠Environment Variables

⁠Volumes

• /data — SQLite database, per-session HLS playlists, and shared HLS cache segments. Keep on persistent storage.
• /media — optional, read-only mount for local media libraries. Remove if you only use remote (SFTP/WebDAV) libraries.

⁠Ports

• 3000 — HTTP web UI and API

⁠Notes

• The first registered user becomes admin; later signup is disabled by default unless an admin enables it.
• Local libraries can watch file changes; remote libraries use manual or scheduled rescans.
• Supported video formats: .mp4, .mkv, .mov, .avi, .webm. Sidecar .vtt/.srt subtitles are supported.
• For HTTPS with Let's Encrypt, see docker-compose.yml⁠ for a Traefik setup.