Add FlareSolverr, Maintainerr, Decluttarr, Checkrr (issue #37)

[joshdev8]

Summary

Adds four *arr-adjacent services from the running-containers screenshot in #37 that weren't yet in the repo:

Service	Port	Network(s)	Purpose
FlareSolverr	8191	media_network	Cloudflare bypass proxy for Prowlarr indexers
Maintainerr	6246	media_network	Rule-based Plex library cleanup
Decluttarr	—	download_network	Removes stalled / failed downloads from *arr queues
Checkrr	8585	media_network	Media file integrity scanner

Decluttarr — note on API keys

Decluttarr needs RADARR_API_KEY and SONARR_API_KEY from .env to actually do anything. Those keys come from the Radarr/Sonarr UIs after the stack is running, so:

• They're added to .env.example with a comment explaining the post-boot workflow.
• Decluttarr's container starts fine with both blank — it just skips any *arr whose key isn't set.
• CLAUDE.md's env-var contract gets a new third category ("Populated after first boot") so the chicken-and-egg is explicitly documented. This is the same confusion that came up in discussion #4.

Other touches

• The old # ============ ERROR MONITORING ============ section header was a misnomer for cleanarr/requestrr. Renamed to LIBRARY MAINTENANCE and grouped the new decluttarr/checkrr/cleanarr together under it. (Requestrr is still in there for now — it doesn't fit either name perfectly.)
• README service table, network architecture lists, and CLAUDE.md network section all updated to reflect the four new services.

Type of change

• New service or feature (feat/)
• Documentation (docs/)

Validation

• docker compose config --quiet passes locally with placeholder env values
• CI's compose-validate.yml workflow exercises the exact path
• Each new service is on the correct network(s) for its peers (FlareSolverr ↔ Prowlarr, Decluttarr ↔ *arrs over download_network, Maintainerr → Plex, Checkrr reading the media library)
• Started locally and confirmed each service comes up healthy (deferred — config edits only)

Related

• Addresses part of #37 (running-containers audit)
• A follow-up PR will handle the monitoring side (Prometheus + cAdvisor + node-exporter), since #37's screenshot also shows those

Summary by CodeRabbit

• New Features

  • Added four media-management services: FlareSolverr, Maintainerr, Decluttarr, and Checkrr.

• Documentation

  • Updated architecture, network mappings, and service table to include the new services and roles.
  • Clarified env var behavior for Decluttarr: API keys are provided after first boot and omitted keys disable corresponding functionality.

• Chores

  • Added optional Decluttarr-related API key entries to the environment template.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 390ec481-92aa-465e-88df-59c425c3127d

📥 Commits

Reviewing files that changed from the base of the PR and between c880d1c and 6714133.

📒 Files selected for processing (4)

• .env.example
• CLAUDE.md
• README.md
• docker-compose.yml

✅ Files skipped from review due to trivial changes (3)

• .env.example
• CLAUDE.md
• README.md

---

📝 Walkthrough

Walkthrough

Adds four services—FlareSolverr, Maintainerr, Decluttarr, and Checkrr—to the Docker Compose stack, introduces Decluttarr env entries in .env.example, and updates README/CLAUDE.md to document network membership and the post-boot API-key behavior for Decluttarr.

Changes

New Media Management Services

Layer / File(s)	Summary
Environment variables for Decluttarr .env.example	Decluttarr configuration section added with optional RADARR_API_KEY and SONARR_API_KEY, with comments explaining source and blank-key behavior.
Docker Compose service definitions docker-compose.yml	Four new services added: flaresolverr and maintainerr on media_network (ports, env, volume), and decluttarr and checkrr (download/media networks, Radarr/Sonarr URLs and API keys, removal flags, UI port, config volume, Plex read-only mount).
Architecture and service documentation CLAUDE.md, README.md	Architecture notes and README updated to list the new services in media_network and download_network; env var contract clarified to mark RADARR/SONARR API keys as populated after first boot and to document Decluttarr behavior when keys are blank.

Estimated Code Review Effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly Related PRs

• joshdev8/AutoPlexx#32: Both PRs modify docker-compose.yml network/compose wiring; this PR adds decluttarr that targets Radarr/Sonarr endpoints.
• joshdev8/AutoPlexx#22: Both PRs adjust media/download network memberships and add maintenance-style services in the compose/network area.
• joshdev8/AutoPlexx#35: Both PRs touch .env.example around Radarr/Sonarr API-key variables; #35 removed them while this PR reintroduces RADARR_API_KEY/SONARR_API_KEY for Decluttarr.

Suggested Labels

enhancement

Poem

🐰 Four new friends hop into the stack,
A proxy, a keeper, a cleaner, a crack.
Networks link, volumes snug and tight,
Keys sleep until the morning light.
Plex hums softly through the night.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title clearly and concisely identifies the main change: adding four new services (FlareSolverr, Maintainerr, Decluttarr, Checkrr) with reference to the related issue.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/arr-companions

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docker-compose.yml`:
- Around line 245-266: The decluttarr service is using v1 env var names
(RADARR_URL, RADARR_KEY, SONARR_URL, SONARR_KEY, REMOVE_TIMER, REMOVE_FAILED)
which v2 ignores; update the decluttarr environment to the v2 schema by
replacing REMOVE_TIMER with TIMER and REMOVE_FAILED with REMOVE_FAILED_DOWNLOADS
and convert the Radarr/Sonarr entries into structured instance blocks (SONARR
and RADARR) each containing base_url and api_key fields (e.g., SONARR: {
base_url: "http://sonarr:8989", api_key: "${SONARR_API_KEY:-}" } and similarly
for RADARR) so the latest image reads your configuration correctly while
retaining TZ and LOG_LEVEL.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: b4c4f6a5-c385-4cc9-aa7a-f9f5a063abd6

📥 Commits

Reviewing files that changed from the base of the PR and between 3a07357 and 5c3d440.

📒 Files selected for processing (4)

• .env.example
• CLAUDE.md
• README.md
• docker-compose.yml