---
title: Install Forgejo Runner on Linux | Snap Store
description: Get the latest version of Forgejo Runner for Linux - A daemon that connects
  to a Forgejo instance and runs jobs for CI.
url: https://snapcraft.io/forgejo-runner-vm
---

# Forgejo Runner (forgejo-runner-vm)

[Enrique Sánchez Cardoso (enriqueesanchz)](https://snapcraft.io/publisher/enriqueesanchz "View all snaps from Enrique Sánchez Cardoso (enriqueesanchz)")

* [Enrique Sánchez Cardoso (enriqueesanchz)](https://snapcraft.io/publisher/enriqueesanchz "View all snaps from Enrique Sánchez Cardoso (enriqueesanchz)")
* [Server and Cloud](https://snapcraft.io/search?categories=server-and-cloud)

latest/edge 12.6.3

Install latest/edge of Forgejo Runner

---

**Install using the command line**

```
sudo snap install forgejo-runner-vm --edge
```

Don't have snapd? [Get set up for snaps](https://snapcraft.io/docs/installing-snapd).

Forgejo Runner is only available on the unstable edge channel. It could break and change often.

---

### Package name

* forgejo-runner-vm

---

### License

* BSD-3-Clause

---

### Last updated

* 25 June 2026 - latest/edge

---

##### Report a Snap Store violation

* [Report this Snap](https://snapcraft.io/forgejo-runner-vm#report-snap-modal)

---

* [Description](https://snapcraft.io/forgejo-runner-vm#tab-description)
* [Security](https://snapcraft.io/forgejo-runner-vm#tab-security)

#### A daemon that connects to a Forgejo instance and runs jobs for CI.

The Forgejo Runner is a lightweight daemon that executes CI/CD jobs (Forgejo Actions)
by polling a Forgejo instance for tasks, running them, and reporting results.
This snap allows for containerized automation and is integrated with Docker (also snap)
for job execution.
To use the snap, configure it with the host URL of your Forgejo instance and a secret token
snap set forgejo-runner host="<HOST>" secret="<SECRET>"

The registration secret for the runner. Mind that this is NOT
as the token. This secret is obtained by running the forgejo-cli command
on the Forgejo server, as an example below:

`forgejo forgejo-cli actions register --secret $SECRET`
`forgejo forgejo-cli actions register --secret $SECRET --labels "docker"`

---

## Install Forgejo Runner on your Linux distribution

Choose your Linux distribution to get detailed installation instructions. If yours is not shown, get more details on the [installing snapd documentation](https://snapcraft.io/docs/installing-snapd).

[### Arch Linux](https://snapcraft.io/install/forgejo-runner-vm/arch)

[### CentOS](https://snapcraft.io/install/forgejo-runner-vm/centos)

[### Debian](https://snapcraft.io/install/forgejo-runner-vm/debian)

[### elementary OS](https://snapcraft.io/install/forgejo-runner-vm/elementary)

[### Fedora](https://snapcraft.io/install/forgejo-runner-vm/fedora)

[### KDE Neon](https://snapcraft.io/install/forgejo-runner-vm/kde-neon)

[### Kubuntu](https://snapcraft.io/install/forgejo-runner-vm/kubuntu)

[### Manjaro](https://snapcraft.io/install/forgejo-runner-vm/manjaro)

[### Pop!\_OS](https://snapcraft.io/install/forgejo-runner-vm/pop)

[### openSUSE](https://snapcraft.io/install/forgejo-runner-vm/opensuse)

[### Red Hat Enterprise Linux](https://snapcraft.io/install/forgejo-runner-vm/rhel)

[### Ubuntu](https://snapcraft.io/install/forgejo-runner-vm/ubuntu)