# Installation Guide

> **Note**: This document is being rebuilt alongside the 1.0.0 codebase.
> Content will be expanded as features are stabilized.

## System Requirements

- **OS**: Ubuntu 20.04+, Debian 11+, or Linux Mint 20+ (x86_64)
- **RAM**: 2GB minimum, 4GB+ recommended
- **Storage**: 10GB free (more for media)
- **CPU**: 2 cores recommended
- **Access**: sudo privileges

## Installation

```bash
git clone https://git.canadabot.net/canadabot/hops.git
cd hops
chmod +x hops install uninstall
sudo ./hops
```

HOPS will install Docker automatically if not present, then walk you through
selecting and deploying services interactively.

## Directory Structure

```
~/hops/                  # Deployment directory
├── docker-compose.yml   # Generated service definitions
├── .env                 # Environment variables and secrets
└── logs/                # HOPS logs

/opt/appdata/            # Application config data
├── jellyfin/
├── sonarr/
└── [other services]/

/mnt/media/              # Media storage
├── movies/
├── tv/
├── music/
└── downloads/
```

## Post-Installation

```bash
# Check service status
cd ~/hops && docker compose ps

# View logs
docker compose logs -f [service-name]

# Access management interface
sudo ./hops
```

## Getting Help

- Issues: [git.canadabot.net/canadabot/hops/issues](https://git.canadabot.net/canadabot/hops/issues)
- Troubleshooting: [TROUBLESHOOTING.md](TROUBLESHOOTING.md)