Sailarr Installer

Fully automated installation script for creating your own media server powered by Real-Debrid and the *Arr stack. One command setup with comprehensive configuration options.

What is This?

This installer deploys a complete media automation stack that streams content from Real-Debrid through Plex, using the *Arr applications (Radarr, Sonarr, Prowlarr) to manage your library. The installer handles everything automatically based on your preferences.

Key Features:

• Fully Interactive Setup - Configure exactly what you need
• Zero Manual Configuration - All services automatically configured and connected
• TRaSH Guide Quality Profiles - Industry-standard quality settings via Recyclarr
• Health Monitoring - Automatic container restarts if issues are detected
• Decypharr Integration - Lightweight Real-Debrid download client with symlink support
• Optional Traefik Integration - Reverse proxy with HTTPS support
• Authentication - Optional password protection for all services

Requirements

• Server: Ubuntu 20.04+ or Debian 11+ (8GB RAM minimum, 16GB recommended)
• Real-Debrid: Active subscription with API token
• Docker & Docker Compose: Must be installed before running the installer
• Storage: 20GB+ available disk space (minimal, 50GB+ recommended)
• Domain (optional): Required only if using Traefik with HTTPS

Quick Start

# Clone the repository
git clone https://github.com/JaviPege/sailarr-installer.git
cd sailarr-installer

# Run the installer
./setup.sh

The installer is fully interactive and will guide you through all configuration options.

📖 For detailed installation instructions, see INSTALLATION.md - This guide explains each configuration option, what happens during installation, and how to troubleshoot common issues.

What Gets Installed

The stack includes these services, configured based on your selections:

Core Services (Always Installed)

• Plex - Media streaming server
• Radarr - Movie management and automation
• Sonarr - TV series management and automation
• Prowlarr - Indexer management for all *Arrs
• Zurg - Real-Debrid WebDAV server
• Rclone - Mounts Zurg as local filesystem
• Zilean - Debrid Media Manager indexer
• PostgreSQL - Database for Zilean
• Overseerr - Media request management
• Autoscan - Automatic Plex library updates

Download Client

• Decypharr - Lightweight and fast, handles Real-Debrid integration

Note: RDTClient is available in the compose files as legacy support but is not configured by the installer.

Additional Services (Always Installed)

• Watchtower - Automatic container updates
• Tautulli - Plex monitoring and statistics
• Homarr - Dashboard for all services
• Dashdot - Server monitoring dashboard
• Pinchflat - YouTube downloader for Plex
• Plex-Trakt-Sync - Sync Plex with Trakt.tv

Optional Services (Configurable)

• Traefik - Reverse proxy with automatic HTTPS (optional, enable during setup)
• Traefik Socket Proxy - Security layer for Traefik (only if Traefik enabled)

Note about Traefik: While the installer configures Traefik and all containers for reverse proxy access, additional network configuration is required on your end:

• DNS records pointing your domain to your server
• Port forwarding (80, 443) on your router/firewall
• Proper firewall rules
• These networking aspects are not covered by this installer and must be configured manually

Installation Options

During installation, you'll configure:

1. Basic Configuration

• Installation Directory - Where to install (default: /mediacenter)
• Timezone - Server timezone (default: Europe/Madrid)
• Real-Debrid API Token - Your Real-Debrid authentication
• Plex Claim Token - Link Plex to your account (optional)

Download client is automatically set to Decypharr.

2. Authentication

• Enable/Disable - Password protect all services
• Username & Password - If authentication enabled

3. Traefik (Reverse Proxy)

• Enable/Disable - Use Traefik for routing
• Domain/Hostname - Your domain name (only if Traefik enabled)

4. Automatic Configuration

• Auto-configure services - Let installer set up all connections
• Install health monitoring - Auto-restart containers on mount failures
• Add cron jobs - Scheduled health checks

Accessing Services

After installation, access your services at different URLs depending on your configuration:

Without Traefik (Direct Access)

• Plex: http://SERVER_IP:32400/web
• Radarr: http://SERVER_IP:7878
• Sonarr: http://SERVER_IP:8989
• Prowlarr: http://SERVER_IP:9696
• Overseerr: http://SERVER_IP:5055
• Zilean: http://SERVER_IP:8181
• Decypharr: http://SERVER_IP:8283
• Tautulli: http://SERVER_IP:8282
• Homarr: http://SERVER_IP:7575
• Dashdot: http://SERVER_IP:3001
• Pinchflat: http://SERVER_IP:8945
• Autoscan: http://SERVER_IP:3030

Replace SERVER_IP with your actual server IP address or hostname.

With Traefik Enabled

Services are accessible via subdomains of your configured domain:

• Plex: https://plex.YOUR_DOMAIN
• Radarr: https://radarr.YOUR_DOMAIN
• Sonarr: https://sonarr.YOUR_DOMAIN
• Prowlarr: https://prowlarr.YOUR_DOMAIN
• Overseerr: https://overseerr.YOUR_DOMAIN
• Zilean: https://zilean.YOUR_DOMAIN
• Decypharr: https://decypharr.YOUR_DOMAIN
• Tautulli: https://tautulli.YOUR_DOMAIN
• Homarr: https://homarr.YOUR_DOMAIN
• Dashdot: https://dashdot.YOUR_DOMAIN
• Pinchflat: https://pinchflat.YOUR_DOMAIN
• Traefik Dashboard: https://traefik.YOUR_DOMAIN

Replace YOUR_DOMAIN with your configured domain name.

Note: If authentication is enabled, you'll be prompted for username/password when accessing any service.

Post-Installation Configuration

After the automated installation completes, some services require manual configuration through their web interfaces:

📖 See docker/POST-INSTALL.md for detailed step-by-step instructions on:

• Overseerr Setup - Connect Plex account, select libraries, and add Radarr/Sonarr servers
• Tautulli Setup - Connect to Plex for analytics and monitoring
• Additional Configuration - Optional tweaks and customizations

The automated installer handles 95% of the setup, but these services need your Plex account credentials or user preferences that can't be automated.

How It Works

The workflow is completely automated:

1. Request content through Overseerr
2. Search - Radarr/Sonarr search indexers via Prowlarr
3. Find - Zilean provides cached torrents from Debrid Media Manager
4. Add - Decypharr adds torrent to Real-Debrid
5. Mount - Zurg exposes Real-Debrid library via WebDAV
6. Access - Rclone mounts Zurg as local filesystem
7. Link - Decypharr creates symlinks to mounted files
8. Import - Radarr/Sonarr import the symlinks
9. Scan - Autoscan triggers Plex library refresh
10. Stream - Watch instantly through Plex

No actual downloading to local storage - everything streams from Real-Debrid.

What the Installer Does

1. Configuration Collection

• Asks all necessary questions
• Validates input
• Creates .env.install with your settings
• Shows configuration summary for confirmation

2. System Preparation

• Creates installation directory
• Sets up user and group permissions
• Creates required subdirectories
• Generates all configuration files

3. Service Deployment

• Generates Docker Compose configuration
• Pulls required Docker images
• Starts containers in correct order
• Waits for services to become healthy

4. Automatic Configuration

If enabled, the installer:

• Extracts API keys from services
• Configures Prowlarr with Zilean indexer
• Connects Radarr/Sonarr to Prowlarr
• Sets up Decypharr as download client in Radarr/Sonarr
• Configures Real-Debrid settings in Decypharr
• Sets root folders for media
• Removes default quality profiles
• Creates TRaSH Guide quality profiles via Recyclarr

5. Health Monitoring

If enabled:

• Installs health check scripts
• Creates cron jobs for automatic monitoring
• Sets up logging

Quality Profiles

Three TRaSH Guide profiles are automatically created:

• Recyclarr-1080p - HD content, upgrades to Remux-1080p
• Recyclarr-2160p - 4K content, upgrades to Remux-2160p
• Recyclarr-Any - Any quality, upgrades to best available

To manually update profiles after installation:

cd /YOUR_INSTALL_DIR
./scripts/recyclarr-sync.sh

Directory Structure

/YOUR_INSTALL_DIR/
├── config/              # Application configurations
│   ├── plex-config/
│   ├── radarr-config/
│   ├── sonarr-config/
│   ├── prowlarr-config/
│   ├── overseerr-config/
│   ├── zilean-config/
│   ├── zurg-config/
│   ├── autoscan-config/
│   ├── decypharr-config/
│   ├── tautulli-config/
│   ├── homarr-config/
│   ├── dashdot-config/
│   ├── pinchflat-config/
│   ├── traefik-config/    # Only if Traefik enabled
│   └── ...
├── data/               # Media and downloads
│   ├── media/
│   │   ├── movies/    # Radarr movies
│   │   └── tv/        # Sonarr TV shows
│   ├── torrents/      # Download client symlinks
│   └── realdebrid-zurg/ # Rclone mount point
├── logs/              # Health check logs
├── docker/            # Docker Compose files
│   ├── up.sh         # Start all services
│   ├── down.sh       # Stop all services
│   ├── restart.sh    # Restart all services
│   └── compose files...
├── setup/            # Setup scripts and libraries
│   ├── lib/         # Modular function libraries
│   └── utils/       # Setup utilities
├── scripts/          # Maintenance scripts
│   ├── health/      # Health check scripts
│   │   ├── arrs-mount-healthcheck.sh
│   │   └── plex-mount-healthcheck.sh
│   ├── maintenance/ # Backup scripts
│   └── recyclarr-sync.sh
├── config/           # Configuration templates
│   ├── recyclarr.yml
│   ├── rclone.conf
│   ├── indexers/
│   └── autoscan/
├── setup.sh          # Main installation script
├── README.md
├── INSTALLATION.md
└── LICENSE

Troubleshooting

Check Service Status

docker ps -a

View Container Logs

docker logs <container_name>

# Examples:
docker logs plex
docker logs radarr
docker logs zurg

Restart All Services

cd /YOUR_INSTALL_DIR/docker
docker compose restart

Check Mount Health

tail -f /YOUR_INSTALL_DIR/logs/plex-mount-healthcheck.log
tail -f /YOUR_INSTALL_DIR/logs/arrs-mount-healthcheck.log

Common Issues

Containers won't start: Check Docker logs and verify Real-Debrid API token is valid

No search results: Wait for Zilean to populate its database (1-2 hours initially)

Files not appearing: Check mount health logs and verify rclone container is healthy

Permission errors: Verify directory ownership matches configured UIDs/GIDs

Traefik 404 errors: Ensure DNS is pointing to your server and containers are healthy

Maintenance

Managing Services

The installation provides convenient scripts for managing all services:

Using helper scripts (recommended):

cd /YOUR_INSTALL_DIR/docker

# Start all services
./up.sh

# Stop all services
./down.sh

# Restart all services
./restart.sh

Using docker compose directly:

cd /YOUR_INSTALL_DIR/docker

# Start all services (without Traefik)
docker compose --env-file .env.defaults --env-file .env.local up -d

# Start all services (with Traefik if enabled)
docker compose --env-file .env.defaults --env-file .env.local --profile traefik up -d

# Stop all services
docker compose --env-file .env.defaults --env-file .env.local down

# Restart all services
docker compose --env-file .env.defaults --env-file .env.local restart

# Restart a specific service
docker restart <container_name>

Note: The helper scripts automatically handle environment files and profiles, making them easier to use.

Health Monitoring

The installer sets up automatic health checks that monitor critical mounts:

How it works:

• Plex health check: Runs every 35 minutes, verifies /data/realdebrid-zurg is accessible
• Arrs health check: Runs every 30 minutes, verifies mounts for Radarr, Sonarr, and Decypharr
• Auto-recovery: If a mount fails, the affected container is automatically restarted
• Logging: All checks are logged to /YOUR_INSTALL_DIR/logs/

View health check logs:

# Plex mount health
tail -f /YOUR_INSTALL_DIR/logs/plex-mount-healthcheck.log

# Arrs mount health
tail -f /YOUR_INSTALL_DIR/logs/arrs-mount-healthcheck.log

Check cron jobs:

crontab -l | grep healthcheck

Manually run health checks:

/YOUR_INSTALL_DIR/scripts/health/plex-mount-healthcheck.sh
/YOUR_INSTALL_DIR/scripts/health/arrs-mount-healthcheck.sh

Update Containers

Watchtower is installed by default and automatically updates containers. To manually update:

cd /YOUR_INSTALL_DIR/docker

# Using helper script (recommended)
./pull.sh
./up.sh

# Or using docker compose directly
docker compose --env-file .env.defaults --env-file .env.local pull
docker compose --env-file .env.defaults --env-file .env.local up -d

View Logs

cd /YOUR_INSTALL_DIR/docker

# All containers
docker compose --env-file .env.defaults --env-file .env.local logs -f

# Specific container
docker logs -f <container_name>

Backup Configuration

# Backup entire config directory
tar -czf mediacenter-backup-$(date +%Y%m%d).tar.gz /YOUR_INSTALL_DIR/config/

Re-running the Installer

If you need to change configuration or reinstall:

# The installer will detect existing .env.install and ask if you want to reuse it
./setup.sh

# To start fresh, delete the existing configuration:
rm .env.install
./setup.sh

Development

This installer was developed step-by-step with guidance and direction, using Claude Code as the development assistant.

Credits & Acknowledgments

This project builds upon the excellent work of many in the community:

• Naralux/mediacenter - Inspiration and foundation for this automated installer
• TRaSH Guides - Quality profiles, custom formats, and best practices
• Savvy Guides / Sailarr's Guide - Comprehensive *Arr stack documentation
• Servarr Wiki - Official documentation and Docker Guide
• Recyclarr - Automated TRaSH Guide syncing
• ElfHosted - Real-Debrid streaming architecture
• Ezarr - Docker *Arr stack approach
• Debrid Media Manager - Torrent caching platform
• dreulavelle/Prowlarr-Indexers - Custom Prowlarr indexer definitions

And all the developers of the tools in this stack: Plex, Radarr, Sonarr, Prowlarr, Overseerr, Zurg, Rclone, Zilean, Decypharr, RDTClient, Autoscan, Traefik, Watchtower, Tautulli, Homarr, Dashdot, Pinchflat, and Plex-Trakt-Sync.

License

MIT License - Use and modify as needed.

Disclaimer

This tool is for educational purposes. Ensure you comply with your local laws and Real-Debrid's terms of service.