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

[Canonical Snapcraft](https://snapcraft.io/)

# Install Forgejo Runner on **Ubuntu**

# 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)

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

#### 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"`

### 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/install/forgejo-runner-vm/ubuntu#report-snap-modal)

---

[See more information about forgejo-runner-vm ›](https://snapcraft.io/forgejo-runner-vm)

## Enable snaps on Ubuntu and install Forgejo Runner

Snaps are applications packaged with all their dependencies to run on all popular Linux distributions from a single build. They update automatically and roll back gracefully.

Snaps are discoverable and installable from the [Snap Store](https://snapcraft.io/store), an app store with an audience of millions.

### Enable snapd

If you’re running [Ubuntu 16.04 LTS (Xenial Xerus)](https://www.ubuntu.com/) or later, including [Ubuntu 18.04 LTS (Bionic Beaver)](https://www.ubuntu.com/desktop/features) and [Ubuntu 20.04 LTS (Focal Fossa)](https://wiki.ubuntu.com/FocalFossa/ReleaseNotes), you don’t need to do anything. Snap is already installed and ready to go.

For versions of Ubuntu between [14.04 LTS (Trusty Tahr)](https://wiki.ubuntu.com/TrustyTahr/ReleaseNotes) and [15.10 (Wily Werewolf)](https://wiki.ubuntu.com/WilyWerewolf/ReleaseNotes), as well as Ubuntu flavours that don’t include *snap* by default, *snap* can be installed from the Ubuntu Software Centre by searching for *snapd*.

Alternatively, snapd can be installed from the command line:

```
sudo apt update
sudo apt install snapd
```

Either log out and back in again, or restart your system, to ensure snap’s paths are updated correctly.

### Install Forgejo Runner

To install Forgejo Runner, simply use the following command:

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

### Other popular snaps…

[See more...](https://snapcraft.io/search?categories=featured)

[See more in Featured](https://snapcraft.io/search?categories=featured)

### More things to do…

#### [Get the snap store](https://snapcraft.io/snap-store)

Browse and find snaps from the convenience of your desktop using the snap store snap.

#### [Learn more about snaps](https://snapcraft.io/docs)

Interested to find out more about snaps? Want to publish your own application? Visit [snapcraft.io](https://snapcraft.io/) now.

[Back to top](https://snapcraft.io/install/forgejo-runner-vm/ubuntu)

© 2026 Canonical Ltd.
Ubuntu and Canonical are registered trademarks of Canonical Ltd.

Powered by [Charmed Kubernetes](https://www.ubuntu.com/kubernetes)

[Join the forum](https://forum.snapcraft.io/), contribute to or report problems with,
[snapd](https://bugs.launchpad.net/snapd),
[Snapcraft](https://bugs.launchpad.net/snapcraft),
or [this site](https://github.com/canonical/snapcraft.io/issues/new).

* [Share on Twitter](https://twitter.com/snapcraftio)
* [Share on Facebook](https://www.facebook.com/snapcraftio)
* [Share on YouTube](https://www.youtube.com/snapcraftio)

* [Terms of Service](https://ubuntu.com/legal/terms-and-policies/snap-store-terms)
* [Data privacy](https://www.ubuntu.com/legal/data-privacy)
* [Manage your tracker settings](https://snapcraft.io/install/forgejo-runner-vm/ubuntu)
* [Service status](https://status.snapcraft.io/)
* [Other functions](https://dashboard.snapcraft.io/)
* [Contact us](https://snapcraft.io/about/contact-us)
