Files
wild-central/dist/README.md

77 lines
1.9 KiB
Markdown

# 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