77 lines
1.9 KiB
Markdown
77 lines
1.9 KiB
Markdown
# Packaging Wild Central
|
|
|
|
## Installation
|
|
|
|
### APT Repository (recommended)
|
|
|
|
```bash
|
|
# Import the signing key
|
|
curl -fsSL https://aptly.cloud2.payne.io/wild-central.gpg \
|
|
| sudo tee /usr/share/keyrings/wild-central.gpg > /dev/null
|
|
|
|
# Add the repository
|
|
sudo tee /etc/apt/sources.list.d/wild-central.sources <<EOF
|
|
Types: deb
|
|
URIs: https://aptly.cloud2.payne.io
|
|
Suites: stable
|
|
Components: main
|
|
Signed-By: /usr/share/keyrings/wild-central.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 (see `.envrc`):
|
|
- `GITEA_TOKEN` — required for `make release` / `make release-edge`
|
|
- `APTLY_URL` / `APTLY_PASS` — required for APT deployment
|