build the server

1. ) sudo -i    # Switch to root
2.) apt update && apt upgrade -y
3.) Create /data directory structure.
        sudo mkdir -p /data/{torrents/{movies,tv,music},media/{movies,tv,music}}
        sudo chown -R $(id -u):$(id -g) /data
        sudo chmod -R 775 /data

4.) Install fail2ban then stop and disable it (as it freezes the install program)
        Stop service: sudo systemctl stop fail2ban
        Disable on boot: sudo systemctl disable fail2ban

4.) curl -fsSL https://get.tomsparkbox.com/install.sh | sudo bash

5.) Run through the checklist wizard.

6.) When the wizard is done, you will need to go into the gluetun config file and add the preshared key and the FIREWALL_VPN_INPUT_PORTS
        # Edit your credentials
        nano /opt/sparkbox/.env
        # Fix VPN_PROVIDER, WIREGUARD_PRIVATE_KEY, etc.
        sparkbox restart media

7.) Go into the systems and set them up.
        Prawlarr up a couple of indexers.
        radaar, sonarr, and qbittorrent and setup the login page
        qbit login and change password   (password in /opt/sparkbox/state/qbittorrent-admin-password.txt)
        Jellyfin wizard + Seerr sign-in, run:

9.) (Auto) Libraries created by media-finish, run sudo sparkbox media-finish


Finding Auto-Generated Credentials
SparkBox pre-seeds a few service passwords and stores them in plaintext files under /opt/sparkbox/state/:

Service	File	               Where to enter it
Portainer	                portainer-admin-password.txt	First login at :9000
qBittorrent	                qbittorrent-admin-password.txt	First login at :8089 (user admin)
Sonarr / Radarr / Prowlarr	auto-configured by arr-bootstrap	Auth disabled on LAN; no password needed
Jellyfin	               none — you pick it	First-run wizard at :8096
Nginx Proxy Manager	none — upstream default	First login: admin@example.com / changeme



"Root Folder Does Not Exist" in Radarr/Sonarr
The /data directory structure has not been created.

        sudo mkdir -p /data/{torrents/{movies,tv,music},media/{movies,tv,music}}
        sudo chown -R $(id -u):$(id -g) /data
        sudo chmod -R 775 /data

/data/
├── torrents/          # qBittorrent downloads here
│   ├── movies/
│   ├── tv/
│   └── music/
└── media/             # Radarr/Sonarr organize here (Jellyfin reads from here)
    ├── movies/
    ├── tv/
    └── music/




CLI Quick Reference
bash
Copy
sparkbox status           # See what's running
sparkbox up               # Start all enabled modules
sparkbox down             # Stop everything
sparkbox restart          # Restart all services
sparkbox restart privacy  # Restart just one module
sparkbox update           # Pull latest app images
sparkbox upgrade          # Upgrade SparkBox itself to the latest release
sparkbox logs sb-NAME     # View service logs
sparkbox modules          # List all modules
sparkbox enable cloud     # Enable a module
sparkbox disable files    # Disable a module
sparkbox backup           # Create a backup
sparkbox restore FILE     # Restore from backup
sparkbox urls             # Show all service URLs
sparkbox help             # Full command list



Uninstalling
bash
Copy
sparkbox down
rm -rf /opt/sparkbox
rm -f /usr/local/bin/sparkbox