runner-images/README.md

runner-images

Official docker images used by act_runner to run workflows.

You can find the images on Docker Hub.

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.

So, we build images from catthehacker/ubuntu:* or node:*, then install additional packages if needed for act_runner to work.

Images

We provide three kinds 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
gitea/runner-images:ubuntu-latest	catthehacker/ubuntu:act-latest
gitea/runner-images:ubuntu-22.04	catthehacker/ubuntu:act-22.04
gitea/runner-images: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
gitea/runner-images:ubuntu-latest-slim	node:20-bookworm-slim
gitea/runner-images:ubuntu-22.04-slim	node:20-bookworm-slim
gitea/runner-images: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
gitea/runner-images:ubuntu-latest-full	catthehacker/ubuntu:full-latest
gitea/runner-images:ubuntu-22.04-full	catthehacker/ubuntu:full-22.04
gitea/runner-images:ubuntu-20.04-full	catthehacker/ubuntu:full-20.04