Stackarr

Private, arr-style media stack control plane for local-first home servers.

Star on GitHub · Docs · Install · Agent MCP · Contributing

---

Stackarr is an arr-style control plane for running a private media stack from a local web dashboard. It wraps setup, service wiring, runtime settings, backups, and trusted-agent maintenance around familiar tools such as Sonarr, Radarr, Prowlarr, Plex, Jellyfin, Seerr, Transmission, and qBittorrent.

Warning

Stackarr is alpha software. Keep the app bound to 127.0.0.1 until the API key, Cloudflare, and public URL settings are configured.

Quick Start

Development checkout:

corepack enable
pnpm install
pnpm dev

Open http://127.0.0.1:7777/setup.

Docker or packaged installs are covered in docs/install.md.

Support The Project

If Stackarr looks useful, please star b-bot/Stackarr on GitHub. Stars help new self-hosters discover the project, give contributors a visible signal, and make release posts easier to trust. Watching releases, sharing the docs with home-server communities, and opening focused issues or pull requests help too.

What It Manages

Surface	Stackarr handles
Dashboard + API	A Next.js local dashboard and arr-style /api/v1 API.
Media services	Docker services for movies, TV, music, books, requests, subtitles, metadata, and indexers.
Media servers	Native or Docker Plex and Jellyfin modes, selected independently.
Operations	Setup, settings, stack lifecycle commands, backups, updates, and diagnostics.
Agent control	Optional local stdio MCP integrations for trusted coding/automation agents.
Access	Optional Cloudflare, Portless, and local-only service routing.

Key Screens

Stack services	UI settings

Docs

• Installation
• Architecture
• MCP and agent integrations
• Manual verification
• Distribution packaging
• Contributing
• Public docs source

Repo Layout

Path	Purpose
apps/frontend	Local Stackarr dashboard and /api/v1 API.
apps/docs	Fumadocs landing/docs deployment app.
packages/core	Shared config, task, service, connection, and notification logic.
packages/ui	Shared presentation primitives.
packages/cli	stackarr executable wrapper package.
packages/mcp	Local stdio MCP server for trusted agents.
packages/agent-plugins	Path-portable Hermes/OpenClaw plugin templates.
distribution	Release packaging.
docs	Maintainer and integration notes.
skills	Agent-facing setup and maintenance instructions.
stackarr	Scripts, presets, hooks, and Docker Compose stack.

Runtime configuration lives in app settings, environment variables, prompts, and local state. Do not publish ignored runtime state such as databases, secrets, logs, generated build output, or machine-specific app data.

License

Stackarr is licensed under GPL-3.0-only.