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>
65 lines
1.8 KiB
Markdown
65 lines
1.8 KiB
Markdown
# 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:
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
sudo ufw status
|
|
sudo ufw allow 8096/tcp comment "Jellyfin"
|
|
sudo ufw delete allow 8096/tcp
|
|
```
|
|
|
|
## File Permissions
|
|
|
|
```bash
|
|
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](INSTALLATION.md).
|
|
For troubleshooting, see [TROUBLESHOOTING.md](TROUBLESHOOTING.md).
|