Capacitarr
Capacitarr is an intelligent media library capacity manager. It monitors disk usage across your media servers and automatically identifies content for cleanup when storage runs low — using a preference-based scoring engine instead of rigid rules.
Join our Discord · r/capacitarr
How It Works
- Connect your integrations — Sonarr, Radarr, Lidarr, Readarr, Plex, Jellyfin, Emby, Tautulli, Jellystat, Tracearr, and Seerr (Overseerr/Jellyseerr).
- Disk groups are auto-detected — Capacitarr tracks capacity per root folder across your integrations.
- Set a threshold — choose when cleanup should trigger (e.g., disk ≥ 85%).
- Adjust preference sliders — tell the engine what you value (watch history, file size, rating, etc.).
- Add protection rules — mark content as untouchable based on quality, tags, genre, or any other property.
- Preview or automate — see exactly what would be deleted before anything happens, or let the engine run automatically.
Documentation
| Section | Description |
|---|---|
| Quick Start | Get Capacitarr running in under 60 seconds |
| Architecture | Service layer, event bus, SSE, and database schema |
| Deployment Guide | Reverse proxy configuration, SSE proxy notes, subdirectory deployments, and authentication |
| Configuration Reference | All environment variables with defaults and descriptions |
| Scoring Algorithm | How items are ranked for deletion — factors, weights, rules, and tiebreakers |
| Notifications | Discord and Apprise notification setup, event tiers, and channel overrides |
| API Documentation | REST API reference, examples, and workflows |
| Release Workflow | Semantic versioning, git-cliff changelog, and CI/CD release pipeline |
Quick Start
services:
capacitarr:
image: ghcr.io/ghent/capacitarr:stable
# Or use Docker Hub: ghentstarshadow/capacitarr:stable
container_name: capacitarr
ports:
- "2187:2187"
environment:
- PUID=1000
- PGID=1000
- JWT_SECRET=change-me-to-a-random-string
volumes:
- capacitarr-config:/config
restart: unless-stopped
volumes:
capacitarr-config:
Then open http://localhost:2187 in your browser to complete setup.
About
Capacitarr is free, open-source software created by Ghent Starshadow. Licensed under PolyForm Noncommercial 1.0.0. Built with Go, Nuxt 4, and SQLite.
🇺🇦 I stand with Ukraine. This project is built with the belief that freedom, sovereignty, and self-determination matter — for people and for software.
🐾 Support Animal Rescue
Capacitarr is free software. The creator strongly prefers that donations go to animal rescue over developer support:
If you still want to support development directly: GitHub Sponsors · Ko-fi · Buy Me a Coffee
Author: Ghent Starshadow