# Packaging Wild Central

## Installation

### APT Repository (recommended)

```bash
# Import the signing key
curl -fsSL https://aptly.cloud.payne.io/public.key \
    | gpg --dearmor | sudo tee /usr/share/keyrings/wild.gpg > /dev/null

# Add the repository
sudo tee /etc/apt/sources.list.d/wild.sources <<EOF
Types: deb
URIs: https://aptly.cloud.payne.io
Suites: stable
Components: main
Signed-By: /usr/share/keyrings/wild.gpg
EOF

sudo apt update && sudo apt install wild-central
```

Use `Suites: edge` for rolling builds from HEAD.

### Manual .deb install

```bash
sudo dpkg -i wild-central_*.deb
sudo apt-get install -f
```

## Quick Start

1. **Start the service**:
   ```bash
   sudo systemctl enable --now wild-central
   ```

2. **Access the web interface**: open `http://your-server-ip` in your browser

3. **Configure** (optional):
   ```bash
   sudo cp /etc/wild-central/config.yaml.example /etc/wild-central/config.yaml
   sudo nano /etc/wild-central/config.yaml
   sudo systemctl restart wild-central
   ```

## Release Artifacts

Each release includes:
- `wild-central_{VERSION}_{arch}.deb` — full install (daemon + web UI)
- `wild-central-{arch}` — standalone daemon binary
- `SHA256SUMS` — checksums for all artifacts

## Developer Tooling

```bash
make help          # Show all targets and current version info
make package-all   # Build all .deb packages
make release       # Stable release: tag + Gitea + APT stable
make release-edge  # Edge release: force-tag + Gitea + APT edge
make deploy-repo   # Deploy packages to APT repository only
```

Directory structure:

```
build/           Intermediate build artifacts
dist/bin/        Standalone binaries
dist/packages/   .deb packages
```

Environment variables (must be set in your environment):
- `GITEA_TOKEN` — required for `make release` / `make release-edge`
- `APTLY_URL` / `APTLY_PASS` — required for APT deployment