# Docs

- [Quick Start](/docs): Install Stackarr with Docker and connect the chat assistant you already use.
- Manage with AI
  - [Agent Setup](/docs/agent/agent-setup): Let a trusted assistant configure Stackarr from chat while you approve the plan.
  - [MCP Connections](/docs/agent/mcp): Connect Codex, Claude, LM Studio, ChatGPT, or another MCP client to Stackarr.
  - [Apps & Routines](/docs/agent/apps-and-routines): Let an agent operate enabled homelab apps and schedule safe multi-step routines.
  - [Hermes & OpenClaw](/docs/agent/plugins): Connect Hermes or OpenClaw to the same Stackarr MCP control plane.
  - [What Agents Can Do](/docs/agent/tools): See the outcomes Stackarr exposes to connected assistants.
  - [Safety & Control](/docs/agent/safety): Understand agent authority, approval prompts, and the activity record.
  - [Agent Activity](/docs/agent/activity)
- Install Stackarr
  - [Install Stackarr](/docs/installation): Run Stackarr as a Docker Compose service on any Docker-compatible host.
  - [Docker Configuration](/docs/installation/docker): Configure Stackarr storage, networking, image versions, and container access.
- Configure your stack
  - [Configure Your Stack](/docs/setup): Choose storage, services, downloads, backups, and access from chat or the dashboard.
  - [Run Setup](/docs/setup/run-setup)
  - [Storage Paths](/docs/setup/storage-paths)
  - [Plex & Jellyfin](/docs/setup/media-servers)
  - [Torrent Client](/docs/setup/torrent-client)
  - [Presets](/docs/setup/presets)
  - [Network Access](/docs/setup/network-access)
  - [Restore and Migrate](/docs/setup/restore-and-migrate)
- Use Stackarr
  - [Stackarr app](/docs/features/dashboard): Use the optional visual control room alongside chat-based homelab management.
  - [Stack](/docs/features/stack)
  - [Media Servers](/docs/features/media-servers)
  - [Activity](/docs/features/activity)
  - [Connect Workflow](/docs/features/connect)
- Integrations
  - [Integrations](/docs/integrations): Service explainers for the apps and infrastructure Stackarr can manage or connect.

  - **Apps**
  - [Agregarr](/docs/integrations/agregarr): Agregarr Plex collection integration overview for Stackarr.
  - [Bazarr](/docs/integrations/bazarr): Bazarr integration overview for Stackarr.
  - [BookOrbit](/docs/integrations/bookorbit): BookOrbit integration overview for Stackarr.
  - [Cleanuparr](/docs/integrations/cleanuparr): Risky-file blocking and queue cleanup in Stackarr.
  - [FlareSolverr](/docs/integrations/flaresolverr): FlareSolverr integration overview for Stackarr.
  - [Immich](/docs/integrations/immich): Immich integration overview for Stackarr.
  - [Jellyfin](/docs/integrations/jellyfin): Jellyfin integration overview for Stackarr.
  - [Lidarr](/docs/integrations/lidarr): Lidarr integration overview for Stackarr.
  - [Maintainerr](/docs/integrations/maintainerr): Maintainerr integration overview for Stackarr.
  - [Plex](/docs/integrations/plex): Plex integration overview for Stackarr.
  - [Prowlarr](/docs/integrations/prowlarr): Prowlarr integration overview for Stackarr.
  - [Pulsarr](/docs/integrations/pulsarr): Pulsarr integration overview for Stackarr.
  - [qBittorrent](/docs/integrations/qbittorrent): qBittorrent integration overview for Stackarr.
  - [Questarr](/docs/integrations/questarr): Add game discovery and downloads beside a RomM-managed library.
  - [Radarr](/docs/integrations/radarr): Radarr integration overview for Stackarr.
  - [Recyclarr](/docs/integrations/recyclarr): Recyclarr integration overview for Stackarr.
  - [RomM](/docs/integrations/romm): Private ROM and game-library management in Stackarr.
  - [Seerr](/docs/integrations/seerr): Seerr integration overview for Stackarr.
  - [Sonarr](/docs/integrations/sonarr): Sonarr integration overview for Stackarr.
  - [Tidarr](/docs/integrations/tidarr): Tidarr music acquisition integration overview for Stackarr.
  - [TinyMediaManager](/docs/integrations/tinymediamanager): TinyMediaManager integration overview for Stackarr.
  - [Tracearr](/docs/integrations/tracearr): Tracearr integration overview for Stackarr.
  - [Transmission](/docs/integrations/transmission): Transmission integration overview for Stackarr.
  - [Youtarr](/docs/integrations/youtarr): Download and manage a private YouTube library with Youtarr.

  - **Services**
  - [Cloudflare](/docs/integrations/cloudflare): Configure a Cloudflare Tunnel, Access allowlist, and per-app public routes in Stackarr.
  - [Docker](/docs/integrations/docker): Docker integration overview for Stackarr.
  - [Postgres](/docs/integrations/postgres): Postgres integration overview for Stackarr.
  - [Redis](/docs/integrations/redis): Redis shared data-service integration overview for Stackarr.
- Settings
  - [Settings](/docs/settings)
  - [General](/docs/settings/general)
  - [Settings Storage](/docs/settings/storage)
  - [Media Management](/docs/settings/media-management)
  - [Download Clients](/docs/settings/download-clients)
  - [Indexers](/docs/settings/indexers)
  - [Metadata](/docs/settings/metadata)
  - [Profiles and Presets](/docs/settings/profiles)
  - [Connect Settings](/docs/settings/connect)
  - [UI Settings](/docs/settings/ui)
- API & automation
  - [API v1](/docs/api/api-v1)
  - [Authentication](/docs/api/authentication)
  - [Commands](/docs/api/commands)
  - [Webhooks](/docs/api/webhooks)
- Operate Stackarr
  - [Backups & Restore](/docs/operations/backups): Protect Stackarr settings and the durable data needed to rebuild your stack.
  - [Updates](/docs/operations/updates): Update Stackarr and the enabled Docker services safely.
  - [Troubleshooting](/docs/operations/troubleshooting): Resolve the most common Stackarr container, storage, and connection problems.
  - [Privacy & Telemetry](/docs/operations/telemetry): See exactly what Stackarr may collect and how to keep it disabled.
  - [Database](/docs/operations/database): Choose the simple default or a shared Postgres service for supported apps.
  - [Image Cleanup](/docs/operations/image-cleanup)
- Security & data
  - [Security](/docs/reference/security)
  - [SQLite](/docs/reference/sqlite)

# Stackarr Homelab Field Notes

Public, source-backed articles about self-hosted infrastructure, media, automation, personal data, smart homes, and game libraries.

- Blog index: https://stackarr.app/blog
- RSS: https://stackarr.app/blog/feed.xml
- JSON Feed: https://stackarr.app/blog/feed.json
- Markdown negotiation: request a canonical blog URL with Accept: text/markdown

## Recent articles

- [Make Jellyfin Transcoding Predictable with Intel Quick Sync in Docker](https://stackarr.app/blog/make-jellyfin-transcoding-predictable-intel-quick-sync-docker): Map an Intel render device into Jellyfin, choose the right Linux acceleration backend, and prove a real transcode before relying on it.
- [Schedule Restic Integrity Checks Without Reading Every Backup at Once](https://stackarr.app/blog/schedule-restic-integrity-checks-without-reading-every-backup): Build a repeatable Restic check cycle, restore into an isolated directory, and preview retention before any destructive maintenance.
- [Fix a RomM Scan That Finds No Platforms](https://stackarr.app/blog/fix-romm-scan-no-platforms): Correct a RomM Docker bind mount, prove the library tree is visible, run a focused scan, and roll back safely if the route is wrong.
- [Move Docker Passwords Out of Environment Variables with Compose Secrets](https://stackarr.app/blog/move-docker-passwords-compose-secrets): Move one Docker Compose password into a file-backed secret, limit service access, test allowed and denied paths, and keep a safe rollback.
- [Index an Existing Photo Archive in Immich Without Copying It](https://stackarr.app/blog/index-existing-photo-archive-immich-without-copying): Add an existing photo archive to Immich with a read-only Docker mount, verify both indexing and denied writes, then keep a safe rollback path.
- [Restrict Homelab SSH with a Least-Privilege Tailscale Policy](https://stackarr.app/blog/restrict-homelab-ssh-least-privilege-tailscale-policy): Limit homelab SSH by group, tagged host, and local account, require periodic re-authentication, and prove both allowed and denied paths.
- [Run a Private Ollama API with Docker and Prove It Is Not Public](https://stackarr.app/blog/private-ollama-api-docker-localhost): Deploy a pinned Ollama container with host-only and container-only access, then prove that LAN and internet paths stay closed.
- [Build a Reliable Matter-over-Thread Network in Home Assistant](https://stackarr.app/blog/build-reliable-matter-over-thread-home-assistant): Create one preferred Thread network, commission Matter devices correctly, test isolation failures, and keep a safe recovery path.
- [Build a Reliable Plex DVR for Over-the-Air TV](https://stackarr.app/blog/build-reliable-plex-dvr-over-the-air-tv): Connect a network TV tuner to Plex, map local channels, record a test program, and verify that guest-network clients cannot reach the tuner.
- [Fix Docker Volume Permission Errors Without Running Everything as Root](https://stackarr.app/blog/fix-docker-volume-permissions-without-root): Diagnose Docker bind-mount permission errors, align container identity safely, and verify both required writes and protected read-only paths.
- [A Backup Isn't Real Until It Restores: A Practical Homelab Drill](https://stackarr.app/blog/test-homelab-backups-with-restore-drill): Build a recoverable homelab plan for Docker volumes, databases, media, secrets, encryption keys, and isolated restore tests.
- [How to Expose a Home Server Safely Without Opening Ports](https://stackarr.app/blog/expose-home-server-safely-without-opening-ports): Set up Cloudflare Tunnel, identity checks, and a narrow email allowlist without exposing a homelab port.