Cleanuparr is a powerful tool that automatically removes completed media from your Sonarr and Radarr libraries based on rules you define. It helps keep your seedbox disk usage under control by cleaning up downloads that have been fully imported and are no longer needed. This guide covers how to set up and configure Cleanuparr on your EvoSeedbox.
Why Use Cleanuparr? #
- Automatically free up disk space by removing completed downloads
- Define custom rules for when media should be cleaned up
- Works with both Sonarr and Radarr
- Set it and forget it — runs on a schedule
- Prevents your seedbox from filling up with old downloads
How It Works #
CLEANUPARR WORKFLOW
═══════════════════
Sonarr / Radarr Cleanuparr
┌──────────────────┐ ┌──────────────────┐
│ Downloads media │ │ Monitors via │
│ Imports to │◀── API ────▶│ Sonarr/Radarr │
│ library │ │ API keys │
└──────────────────┘ └────────┬─────────┘
│
Checks your rules:
• Age > X days?
• Seeding complete?
• Already imported?
│
▼
┌──────────────────┐
│ Removes from │
│ download client │
│ + deletes files │
└──────────────────┘
Result: Disk space freed automatically
Step 1: Install Cleanuparr #
Log in to client.evoseedbox.com, go to Services > My Services, click Manage on your seedbox, and find the Cleanuparr app card. Click Install.
Installation takes about 30 seconds. Once complete, the app card will show Open and Manage buttons.
INSTALLATION FLOW
═════════════════
Client Area: Click "Install"
│
▼
┌─────────────────────┐
│ Docker container │
│ created with your │
│ user permissions │
└─────────┬───────────┘
│
▼
┌─────────────────────┐
│ SSL certificate │
│ provisioned via │
│ Caddy reverse proxy │
└─────────┬───────────┘
│
▼
┌─────────────────────┐
│ App card shows │
│ "Open" button │
└─────────────────────┘
Step 2: Access Cleanuparr #
Click Open on the Cleanuparr app card, or navigate directly to your Cleanuparr URL (shown in the client area). The URL format is:
https://YOURSERVER.myseedbox.site:PORTYou will first see a browser login popup (Basic Authentication). Enter your seedbox credentials:
LOGIN PROCESS — Two Steps
═══════════════════════════════════════════════════
STEP 1: Browser Login Popup (Basic Auth)
──────────────────────────────────────────────────
┌─────────────────────────────────────┐
│ Sign in to YOURSERVER.myseedbox │
│ │
│ Username: [your_seedbox_username] │ ◀── Seedbox credentials
│ Password: [your_seedbox_password] │ from client area
│ │
│ [Cancel] [Sign In] │
└─────────────────────────────────────┘
STEP 2: Cleanuparr Setup Page (first time only)
──────────────────────────────────────────────────
┌─────────────────────────────────────┐
│ Create Your Account │
│ │
│ Username: [pick_any_username] │ ◀── Choose ANY username
│ Password: [pick_any_password] │ for Cleanuparr itself
│ Confirm: [same_password] │
│ │
│ [Create Account] │
└─────────────────────────────────────┘
Important: There are two separate logins. The first popup uses your seedbox credentials. After that, Cleanuparr shows its own login/setup page where you create a new account — you can choose any username and password you like for this.
Step 3: Connect Sonarr #
Once logged in to Cleanuparr, go to Settings and add Sonarr as a source:
- Click Add Instance or the + button
- Select Sonarr as the type
- Enter a name (e.g. “My Sonarr”)
- For the URL, use your Sonarr’s local Docker address:
http://sonarr.YOURUSERNAME:PORT(shown in appInfo.txt) or your Sonarr SSL URL from the client area - For the API Key, open Sonarr in your browser, go to Settings > General, and copy the API key
- Click Test to verify the connection, then Save
FINDING YOUR SONARR API KEY
═══════════════════════════════════════════════════
Open Sonarr in your browser
│
▼
Settings > General
│
▼
┌─────────────────────────────────────┐
│ Security │
│ │
│ API Key: abc123def456ghi789... │ ◀── Copy this
│ [Copy] [Reset] │
│ │
│ Authentication: Forms (Login Page) │
└─────────────────────────────────────┘
Paste the API key into Cleanuparr's settings
Step 4: Connect Radarr #
Repeat the same process for Radarr: add a new instance, select Radarr, enter the URL and API key (found in Radarr’s Settings > General), test, and save.
Step 5: Configure Cleanup Rules #
Cleanuparr lets you define rules for when to remove media. Common configurations include:
EXAMPLE CLEANUP RULES
═══════════════════════════════════════════════════
Rule 1: "Remove after seeding"
──────────────────────────────────────────────────
Condition: Download imported = Yes
Seeding time > 48 hours
Action: Remove from client + delete files
Rule 2: "Remove old downloads"
──────────────────────────────────────────────────
Condition: Download age > 7 days
Status = Completed
Action: Remove from client + delete files
Rule 3: "Remove failed"
──────────────────────────────────────────────────
Condition: Status = Failed
Age > 1 day
Action: Remove + blacklist
Cleanuparr runs its seeker job every 10 minutes by default to check for media that matches your rules.
Understanding the Dashboard #
CLEANUPARR DASHBOARD
═══════════════════════════════════════════════════
┌─────────────────────────────────────────────────┐
│ Cleanuparr [Settings] [Logs]│
├─────────────────────────────────────────────────┤
│ │
│ Connected Instances │
│ ┌──────────┐ ┌──────────┐ │
│ │ Sonarr │ │ Radarr │ │
│ │ Online │ │ Online │ │
│ └──────────┘ └──────────┘ │
│ │
│ Recent Activity │
│ ────────────────────────────────────────── │
│ Removed: Movie.Name.2024 (freed 4.2 GB) │
│ Removed: TV.Show.S01 (freed 12.1 GB) │
│ Skipped: Movie.Other (still seeding) │
│ │
│ Disk Saved: 156 GB total │
└─────────────────────────────────────────────────┘
Troubleshooting #
Browser login popup appears but credentials don’t work #
Cause: You may be entering the wrong credentials in the browser popup.
Fix: The browser popup requires your seedbox credentials (the same username and password you use to access ruTorrent), not the Cleanuparr account. Check your credentials in the client area under Services > My Services > Manage.
Can’t create an account / setup page won’t load #
Cause: The first time you access Cleanuparr, it shows a setup page to create your initial account. If this page doesn’t load, Cleanuparr may not be running.
Fix: Go to the client area and click Restart on the Cleanuparr app card. Wait 30 seconds and try again.
Cleanuparr can’t connect to Sonarr/Radarr #
Cause: Wrong URL or API key.
Fix: Use the SSL URL from your client area (e.g. https://yourserver.myseedbox.site:PORT). Make sure the API key is copied correctly from the app’s Settings > General page. Use the Test button to verify.
“Connection refused” or blank page #
Cause: The Cleanuparr container may have stopped.
Fix: Restart Cleanuparr from the client area. If the issue persists, open a support ticket and we’ll check the container configuration.
TROUBLESHOOTING CHECKLIST
═════════════════════════
1. Browser Login (Basic Auth)
├── Using seedbox username ✓
├── Using seedbox password ✓
└── NOT Cleanuparr credentials ✓
2. Cleanuparr Login
├── Account created (first time) ✓
└── Using Cleanuparr credentials ✓
3. Sonarr/Radarr Connection
├── Correct SSL URL ✓
├── API key copied correctly ✓
└── Test button shows success ✓
4. App Status
├── App card shows "Open" ✓
└── Restart if not responding ✓
Tips & Best Practices #
- Start conservative: Set longer retention periods first (e.g. 7 days), then reduce once you’re comfortable with how Cleanuparr works
- Check the logs: Cleanuparr logs every action — review them to make sure it’s removing what you expect
- Don’t remove while seeding: Set rules to only remove media after seeding is complete to maintain your ratio on private trackers
- Use with disk monitoring: Cleanuparr works best as a preventive measure — don’t wait until your disk is full
