# forgejo-actions configuration

This repository contains a few configuration files for the CTBK Forgejo Actions runner. This repository is checked out to the `/etc/forgejo-runner` directory.

## Containers available in CTBK Forgejo Actions

We provide a few containers for you to use:

- `ubuntu-latest`: A container [provided by `catthehacker`](https://ghcr.io/catthehacker/ubuntu:act-24.04) that mostly mimics the GitHub `ubuntu-latest` runner. Use this if you simply want to run CI based on existing GitHub Actions configurations. While compatibility is not guaranteed (please read the [Forgejo Actions documentation](https://forgejo.org/docs/latest/user/actions/) either way), we’re certain it will just work in most cases.
- `alpine`: The `alpine:latest` (aka. `edge`) container, which is the official Alpine container. Use this container if you’re writing a new action. It is fast and small :)
- `alpine-latex`: An Alpine container with most TeX Live utilities preinstalled. This container is built from our [Containerfile](Containerfile.alpine-latex) once per week. Use this if you need to build LaTeX files (ideally with XeTeX) -- it saves a lot of CI time.

All three containers are also published to the [local container registry](https://git.ctbk.de/infra/-/packages), so you can test your actions locally with `forgejo-runner exec`.