Is Forgejo Runner in the official Debian repositories?

No, Forgejo Runner is not packaged in the official Debian archives. This repository is currently the only apt source, serving Forgejo Runner 13.0.0.

How do I install the latest Forgejo Runner on Debian?

Add the deb.griffo.io repository once using the instructions above, then run: sudo apt install forgejo-runner. New releases arrive through the normal sudo apt upgrade.

Are the packages signed and how are they built?

Every package is signed with the repository's GPG key (EA0F721D231FDD3A0A17B9AC7808B4DD62C41256) and built from upstream releases in public GitHub packaging repositories that anyone can inspect.

Which Debian releases are supported?

Debian 12 Bookworm, Debian 13 Trixie, Forky and Sid.

Install Latest Forgejo Runner on Debian via apt

Source	Version
deb.griffo.io	13.0.0 ✅
Official Debian	🚫 not packaged

← Back to home

What is Forgejo Runner?

Forgejo Runner is the CI runner for Forgejo Actions. It is a lightweight daemon that connects to your Forgejo instance, picks up queued workflow jobs and executes them on your own infrastructure (using Docker, LXC or the host directly) giving you a fully self-hosted, GitHub Actions-compatible CI/CD pipeline.

            🚀 Why Latest Versions Matter: The runner tracks Forgejo releases closely, adding support for new workflow features, better isolation and bug fixes. Keeping it current ensures compatibility with the latest Forgejo Actions capabilities.
        

⚡ Key Features of Forgejo Runner

🔁 Actions Compatible

Runs workflows using the same syntax and actions ecosystem as GitHub Actions.

🐳 Flexible Execution

Execute jobs in Docker containers, LXC, or directly on the host machine.

🔐 Self-hosted

Keep your CI/CD entirely on your own infrastructure with no third-party dependency.

⚖️ Scalable

🎯 Why Forgejo Runner?

Own your CI: Run pipelines on hardware you control
Actions ecosystem: Reuse existing GitHub-style workflow definitions
Flexible isolation: Docker, LXC or host execution to fit your needs
Lightweight: A single Go binary that is simple to deploy

🆕 Highlights

Job Execution: Runs queued Forgejo Actions workflows
Labels: Target jobs to specific runners
Container Support: Isolated builds via Docker
Daemon Mode: Runs continuously as a service

📦 Installation from deb.griffo.io

Run the commands

Step 1: Add Repository

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt update

install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt update

sudo apt install extrepo
sudo extrepo enable griffo
sudo apt update

🆓 There is an always-free mirror. deb-free.griffo.io serves packages free forever, no account, no subscription, at most 2 months behind upstream, security fixes immediately. It currently carries cliamp, Ghostty, lazydocker, Oh My Posh and Zed; Forgejo Runner is not one of them, so the repository above is the only way to get it today, ask and it can be enrolled.

How the free mirror works →

🧩 About the extrepo option. extrepo is Debian's own tool for external repositories: it writes the sources file and installs the signing key for you, checking the key against signed metadata first. This repository is registered with it as griffo, and the always-free mirror as griffo-free, so on Debian (bookworm, trixie, forky and sid) the commands above are the whole setup.

extrepo sets up the sources file and the key only, so a subscription's credentials still go in /etc/apt/auth.conf.d/deb.griffo.io.conf. Ubuntu is not covered, because extrepo publishes metadata for Debian suites only: there, use the sudo or root commands.

Step 2: Install forgejo-runner

# Install latest forgejo-runner
sudo apt install forgejo-runner

# Verify installation
forgejo-runner --version

# Install latest forgejo-runner
apt install forgejo-runner

# Verify installation
forgejo-runner --version

🎯 Basic Usage Examples

# Show version
forgejo-runner --version

# Generate a default config file
forgejo-runner generate-config > config.yaml

# Register the runner with your Forgejo instance
forgejo-runner register --instance https://forgejo.example.com --token <TOKEN>

# Start the runner daemon
forgejo-runner daemon

🚀 Why Choose deb.griffo.io?

📊 Repository Comparison:

Official Debian: Often months behind, missing latest features
deb.griffo.io: Latest version within hours of release
Manual Installation: Manual downloads and PATH setup required
Our Repository: Pre-built, ready-to-use packages

✅ Latest Features: Get newest Forgejo Runner features and improvements immediately
✅ No Manual Setup: Pre-built binaries, installed and updated through apt
✅ Automatic Updates: Packages updated within hours of upstream releases
✅ Proper Dependencies: Correctly packaged with all required libraries
✅ Multi-Distribution: Works on Bookworm, Trixie, and Sid
✅ Easy Maintenance: Simple apt commands for updates

📦 Package Build Repository

The Debian packages are automatically built and maintained in this GitHub repository:

📁 forgejo-runner-debian - Latest release builds

🔗 Related Packages

Also available from deb.griffo.io:

Forgejo - Self-hosted lightweight software forge
Garage - S3-compatible distributed object storage
Headscale - Self-hosted Tailscale control server

            🎯 Perfect for: Teams and individuals self-hosting Forgejo who want to run their own CI/CD pipelines with full control over the build environment and infrastructure.
        

💝 Support This Project

If this repository saves you time and effort, please consider supporting it!

⭐ Star on GitHub 🐦 Share on Twitter

⚙️ Install Latest Forgejo Runner on Debian