Stephen Klein
a7213441da
ADVANCED.md, INSTALLATION.md, and TROUBLESHOOTING.md were ~60-70% stale: references to deleted Path B scripts, macOS/WSL2 platform sections, old GitHub URLs, and v3.1-3.3 version history. Pruned to accurate Linux-only stubs to be rebuilt as the 1.0.0 codebase stabilises. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1.8 KiB
1.8 KiB
Advanced Configuration
This guide covers advanced HOPS configuration and system administration.
Note
: This document is being rebuilt alongside the 1.0.0 codebase. Content will be expanded as features are stabilized.
Environment Variables
HOPS writes a .env file to ~/hops/ during installation. Key variables:
PUID=1000 # User ID (run: id -u)
PGID=1000 # Group ID (run: id -g)
TZ=America/New_York # Timezone
DATA_ROOT=/mnt/media # Media storage
CONFIG_ROOT=/opt/appdata # App configurations
DEFAULT_ADMIN_PASSWORD=... # Auto-generated
DEFAULT_DB_PASSWORD=... # Auto-generated
Docker Compose Commands
cd ~/hops
docker compose ps # List services
docker compose up -d # Start all services
docker compose down # Stop all services
docker compose restart [service] # Restart a service
docker compose logs -f [service] # Follow logs
docker compose logs --tail=100 [service] # Last 100 lines
docker compose pull # Pull new images
docker compose up -d --force-recreate # Recreate containers
docker stats # Real-time resource usage
docker system df # Disk usage
docker system prune # Clean unused data
Firewall
HOPS configures UFW automatically on Linux. Manual management:
sudo ufw status
sudo ufw allow 8096/tcp comment "Jellyfin"
sudo ufw delete allow 8096/tcp
File Permissions
chmod 600 ~/hops/.env
chmod 644 ~/hops/docker-compose.yml
sudo chown -R $USER:$USER /opt/appdata
sudo chown -R $USER:$USER /mnt/media
For installation, see INSTALLATION.md. For troubleshooting, see TROUBLESHOOTING.md.