Files
arr-suite-template-bootstrap/docs/SERVICE_ACCESS.md
openhands 24f2cd64e9 Initial template repository
🎬 ARR Suite Template Bootstrap - Complete Media Automation Stack

Features:
- 16 production services (Prowlarr, Sonarr, Radarr, Plex, etc.)
- One-command Ansible deployment
- VPN-protected downloads via Gluetun
- Tailscale secure access
- Production-ready security (UFW, Fail2Ban)
- Automated backups and monitoring
- Comprehensive documentation

Ready for customization and deployment to any VPS.

Co-authored-by: openhands <openhands@all-hands.dev>
2025-11-28 04:26:12 +00:00

7.5 KiB

🌐 Service Access Guide

This guide provides direct access URLs for all services in your Arrs media stack deployment.

Tailscale IP: YOUR_TAILSCALE_IP

All services are accessible via your Tailscale network for secure remote access:

📺 Core Media Management (The Arrs)

Service URL Purpose Default Login
Sonarr http://YOUR_TAILSCALE_IP:8989 TV show management & automation No default login
Radarr http://YOUR_TAILSCALE_IP:7878 Movie management & automation No default login
Lidarr http://YOUR_TAILSCALE_IP:8686 Music management & automation No default login
Bazarr http://YOUR_TAILSCALE_IP:6767 Subtitle management & automation No default login
Prowlarr http://YOUR_TAILSCALE_IP:9696 Indexer management & search No default login
Whisparr http://YOUR_TAILSCALE_IP:6969 Adult content management No default login

⬇️ Download Clients (VPN Protected)

Service URL Purpose Default Login
SABnzbd http://YOUR_TAILSCALE_IP:8080 Usenet downloader (via VPN) Setup wizard on first run
qBittorrent http://YOUR_TAILSCALE_IP:8081 BitTorrent client (via VPN) admin / adminadmin

⚠️ Important: Change qBittorrent default password immediately after first login!

🎬 Media Server & Management

Service URL Purpose Default Login
Plex http://YOUR_TAILSCALE_IP:32400/web Media streaming server Plex account required
Tautulli http://YOUR_TAILSCALE_IP:8181 Plex monitoring & statistics No default login
Jellyseerr http://YOUR_TAILSCALE_IP:5055 Media request management Setup wizard on first visit

📺 YouTube Archiving

Service URL Purpose Default Login
TubeArchivist http://YOUR_TAILSCALE_IP:8000 YouTube content archiving Setup wizard on first visit

🌍 Public Internet Access

If you've enabled public access in your configuration, services are also accessible via your VPS public IP:

📺 Core Media Management

  • Sonarr: http://YOUR_VPS_IP:8989
  • Radarr: http://YOUR_VPS_IP:7878
  • Lidarr: http://YOUR_VPS_IP:8686
  • Bazarr: http://YOUR_VPS_IP:6767
  • Prowlarr: http://YOUR_VPS_IP:9696
  • Whisparr: http://YOUR_VPS_IP:6969

⬇️ Download Clients

  • SABnzbd: http://YOUR_VPS_IP:8080
  • qBittorrent: http://YOUR_VPS_IP:8081

🎬 Media Server & Management

  • Plex: http://YOUR_VPS_IP:32400/web
  • Tautulli: http://YOUR_VPS_IP:8181
  • Jellyseerr: http://YOUR_VPS_IP:5055

📺 YouTube Archiving

  • TubeArchivist: http://YOUR_VPS_IP:8000

🔐 Security Recommendations

  • Secure: All traffic encrypted through Tailscale VPN
  • Private: Services not exposed to public internet
  • Convenient: Access from any device with Tailscale installed
  • No port forwarding: No need to open firewall ports

🌐 Public Access Considerations

  • ⚠️ Security Risk: Services exposed to public internet
  • 🔒 Authentication: Ensure strong passwords on all services
  • 🛡️ Firewall: UFW firewall provides basic protection
  • 📊 Monitoring: Fail2ban monitors for intrusion attempts

🚀 Quick Access Bookmarks

Save these bookmarks for easy access to your media stack:

📱 Mobile/Tablet Bookmarks

Sonarr TV: http://YOUR_TAILSCALE_IP:8989
Radarr Movies: http://YOUR_TAILSCALE_IP:7878
Plex Media: http://YOUR_TAILSCALE_IP:32400/web
Jellyseerr Requests: http://YOUR_TAILSCALE_IP:5055

💻 Desktop Bookmarks

Media Management Dashboard:
├── Sonarr (TV): http://YOUR_TAILSCALE_IP:8989
├── Radarr (Movies): http://YOUR_TAILSCALE_IP:7878
├── Lidarr (Music): http://YOUR_TAILSCALE_IP:8686
├── Bazarr (Subtitles): http://YOUR_TAILSCALE_IP:6767
├── Prowlarr (Indexers): http://YOUR_TAILSCALE_IP:9696
└── Whisparr (Adult): http://YOUR_TAILSCALE_IP:6969

Download Clients:
├── SABnzbd: http://YOUR_TAILSCALE_IP:8080
└── qBittorrent: http://YOUR_TAILSCALE_IP:8081

Media & Monitoring:
├── Plex Server: http://YOUR_TAILSCALE_IP:32400/web
├── Tautulli Stats: http://YOUR_TAILSCALE_IP:8181
├── Jellyseerr Requests: http://YOUR_TAILSCALE_IP:5055
└── TubeArchivist: http://YOUR_TAILSCALE_IP:8000

🔧 Service Configuration Tips

🎯 First-Time Setup Priority

  1. Prowlarr (http://YOUR_TAILSCALE_IP:9696) - Configure indexers first
  2. Sonarr/Radarr/Lidarr - Add Prowlarr as indexer source
  3. Download Clients - Configure qBittorrent/SABnzbd in Arrs
  4. Plex - Add media libraries and configure remote access
  5. Jellyseerr - Connect to Plex and configure user requests

📊 Monitoring Setup

  1. Tautulli - Connect to Plex for detailed statistics
  2. Health Dashboard - SSH to VPS and run health command
  3. VPN Status - Check docker logs gluetun for VPN connection

🔐 Security Setup

  1. Change Default Passwords: qBittorrent admin password
  2. Enable Authentication: Set up auth on services that support it
  3. Review Firewall: Check UFW status with sudo ufw status
  4. Monitor Logs: Check /var/log/arrs/ for monitoring logs

📞 Support & Troubleshooting

If you can't access a service:

  1. Check Service Status: docker ps to see running containers
  2. Check Logs: docker logs [service-name] for error messages
  3. Check Firewall: sudo ufw status to verify port access
  4. Check Tailscale: Ensure Tailscale is connected on your device
  5. Health Dashboard: Run /usr/local/bin/health-dashboard.sh on VPS

🔧 Specific Service Troubleshooting

🚨 TubeArchivist Not Loading

If TubeArchivist (http://YOUR_TAILSCALE_IP:8000) shows connection errors:

# Check all TubeArchivist containers
docker ps | grep tubearchivist

# Restart in correct order (dependencies first)
docker-compose restart tubearchivist-es
sleep 30
docker-compose restart tubearchivist-redis  
sleep 10
docker-compose restart tubearchivist

# Check logs if still not working
docker-compose logs -f tubearchivist

🔄 Download Client Port Mix-up

If ports are swapped (SABnzbd on 8081, qBittorrent on 8080):

# Restart VPN container and download clients
docker-compose restart gluetun
sleep 30
docker-compose restart qbittorrent sabnzbd

# Verify correct mapping
curl -I http://YOUR_TAILSCALE_IP:8080  # Should show SABnzbd
curl -I http://YOUR_TAILSCALE_IP:8081  # Should show qBittorrent

🌐 VPN Connection Issues

If download clients show "Unauthorized" or won't load:

# Check VPN status
docker-compose logs gluetun | tail -20

# Restart entire VPN stack
docker-compose down qbittorrent sabnzbd gluetun
docker-compose up -d gluetun
sleep 60
docker-compose up -d qbittorrent sabnzbd

🎉 Enjoy Your Media Stack!

Your complete Arrs media management stack is now accessible via Tailscale at YOUR_TAILSCALE_IP. All services are running and ready for configuration!

Next Steps:

  1. Configure Prowlarr with your preferred indexers
  2. Set up Sonarr/Radarr with your media preferences
  3. Configure download clients with VPN protection
  4. Add media libraries to Plex
  5. Set up Jellyseerr for user requests

Happy streaming! 🍿📺🎵