update

2026-07-23 19:38:14 -04:00
parent 72272e4006
commit 84e1ead50c
283 changed files with 0 additions and 206 deletions
@@ -0,0 +1,91 @@
+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