Forge Package Repository

Forge Package Repository

Arch Linux and Ubuntu packages for the Forge Infrastructure Management System.

📦 Available Packages

🚀 Quick Setup (Arch Linux)

1. Add GPG Keys

# Import both signing keys (some packages use different keys)
curl -O https://pkg.forge.meshping.net/formation-signing-key.asc
curl -O https://pkg.forge.meshping.net/forge-signing-key.asc
sudo pacman-key --add formation-signing-key.asc
sudo pacman-key --add forge-signing-key.asc
sudo pacman-key --lsign-key 3FEF1F69868D3E4B42FDBDA2B887956FB5D8B0C6
sudo pacman-key --lsign-key A54F639C38CE89BF5F1495FF40EB70E3A6B0402B

2. Add Repository

Add to /etc/pacman.conf:

[forge]
Server = https://pkg.forge.meshping.net/
SigLevel = Required

3. Install Packages

# Update package database
sudo pacman -Sy

# Install forge components
sudo pacman -S forge-agent forge-config forge-docs

🐧 Quick Setup (Ubuntu)

Ubuntu packages are static musl builds, so they install on older releases as well as current ones. They are amd64 only.

1. Add the Signing Key

curl -O https://pkg.forge.meshping.net/apt/forge.gpg
sudo install -m 644 forge.gpg /usr/share/keyrings/

2. Add the Repository

Create /etc/apt/sources.list.d/forge.sources:

Types: deb
URIs: https://pkg.forge.meshping.net/apt
Suites: stable
Components: main
Signed-By: /usr/share/keyrings/forge.gpg

3. Install Packages

sudo apt update
sudo apt install forge-rpcd

The package creates the forge-rpcd user and installs the systemd unit. It does not ship /etc/forge/rpcd.conf; write it on the host before starting the service:

sudo systemctl enable --now forge-rpcd

🔧 Manual Repository Setup

To set up your own repository mirror:

  1. Build packages (from /src/forge/):

    ./scripts/build-forge-repo.sh
  2. Copy repository files:

    # Copy all repository files to your web server
    rsync -av /shared/forge/packages/ your-server:/path/to/repo/
  3. Update clients to use your server URL in /etc/pacman.conf

📋 Repository Structure

/shared/forge/packages/
├── forge.db.tar.zst           # Package database
├── forge.files.tar.zst        # File database  
├── formation-signing-key.asc  # Formation GPG signing key
├── forge-signing-key.asc      # Forge GPG signing key
├── forge-agent-0.4.5-1-x86_64.pkg.tar.zst
├── forge-config-1.3.1-1-x86_64.pkg.tar.zst
├── forge-docs-0.1.0-1-x86_64.pkg.tar.zst
└── *.sig                      # Package signatures

🔑 Package Verification

All packages are signed with GPG. To verify manually:

# Verify signature
gpg --verify forge-agent-0.4.5-1-x86_64.pkg.tar.zst.sig

# Check package integrity  
pacman -Qkk forge-agent