# 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).