Runner Images
Official docker images used by act_runner to run workflows.
You can find the images on gitea/runner-images.
Currently, we have not chosen to build the image ourselves, as catthehacker/docker_images has done an excellent job of this. We don't need to reinvent the wheel.
Images are built from catthehacker/ubuntu:*
or node:*
.
Additional packages will be installed if they are needed by act_runner
.
Images
Here are three types of images: "default", "slim", and "full".
Default images
Default images are based on catthehacker/ubuntu:act-*
, and are used by default in act_runner.
They contain most of the tools needed to run workflows and are always recommended if your runner is not disk-space constrained.
Tag | Base | Size | Version |
---|---|---|---|
ubuntu-latest | catthehacker/ubuntu:act-latest |
||
ubuntu-22.04 | catthehacker/ubuntu:act-22.04 |
||
ubuntu-20.04 | catthehacker/ubuntu:act-20.04 |
Slim images
Slim images are based on node:20-*-slim
.
They contain Node.js to run basic workflows and set up more development tools if needed.
Their size is much smaller, which is friendly to disk-space constrained runners.
Tag | Base | Size | Version |
---|---|---|---|
ubuntu-latest-slim | node:20-bookworm-slim |
||
ubuntu-22.04-slim | node:20-bookworm-slim |
||
ubuntu-20.04-slim | node:20-bullseye-slim |
Full images
Full images are based on catthehacker/ubuntu:full-*
, which contains all tools provided by GitHub Actions runners.
They have huge sizes, but are useful if you need to run workflows in a GitHub Actions compatible environment.
Please note that full images support amd64 architecture only.
Tag | Base | Size | Version |
---|---|---|---|
ubuntu-latest-full | catthehacker/ubuntu:full-latest |
||
ubuntu-22.04-full | catthehacker/ubuntu:full-22.04 |
||
ubuntu-20.04-full | catthehacker/ubuntu:full-20.04 |
Migration
If you have already installed a runner which uses node:16-*
or node:20-*
as default images, you can migrate to the new images by following the steps:
- Ensure your Gitea's version is v1.21.0 or later.
- Ensure your act_runner's version is v0.2.9 or later.
- Update your runner's configuration file like
config.yaml
:# ... runner: # ... labels: - "ubuntu-latest:docker://gitea/runner-images:ubuntu-latest" - "ubuntu-22.04:docker://gitea/runner-images:ubuntu-22.04" - "ubuntu-20.04:docker://gitea/runner-images:ubuntu-20.04" container: # ... force_pull: true # ...
- Restart your runner.