STACKIT Runners
Last updated on
STACKIT Runners are managed execution environments used to run jobs in STACKIT Git Pipelines.
They are operated and maintained by STACKIT, so you do not need to provision or manage your own build infrastructure.
With managed runners, pipeline jobs run in isolated environments that automatically scale based on workload.
Enable STACKIT runners
Section titled “Enable STACKIT runners”Before pipelines can execute jobs, runners must be enabled for your Git instance.
- Open the STACKIT Portal.
- Navigate to your Project.
- Select Developer Platform → Git.
- Choose your Git instance from the list.
- Open the Runner configuration section.
- Select the runner images and labels you want to enable.
- Click Create to activate the runners.
After enabling runners, you can reference them in your pipeline workflows using the runs-on label.
Available runner images
Section titled “Available runner images”STACKIT provides a set of predefined runner environments. Each runner is identified by a label that you reference in your pipeline configuration.
Use these labels in the runs-on field of your workflow.
| Label | Base OS | Included tools |
|---|---|---|
stackit-docker | Ubuntu 22.04 (ACT environment) | Docker, Node.js, Python, Git, build-essential |
stackit-ubuntu-20 | Ubuntu 20.04 | Ubuntu base environment with broad GitHub Actions compatibility |
stackit-ubuntu-22 | Ubuntu 22.04 | Standard Ubuntu base image |
stackit-busybox | Busybox (stable) | Minimal environment for scripts and binaries |
stackit-alpine | Alpine Linux | Lightweight Alpine environment |
stackit-alpine-bash | Alpine Linux | Alpine environment with Bash support |
stackit-coretto-21 | Amazon Corretto 21 | Java runtime with JDK |
Scalability and reliability
Section titled “Scalability and reliability”STACKIT runners are designed to provide reliable and scalable pipeline execution.
Scalability
- Runners automatically scale depending on the number of queued jobs.
- Jobs are executed as soon as compute capacity is available.
Security
- Each job runs in a fresh, ephemeral execution environment.
- The environment is destroyed immediately after the job completes.
- No data or credentials persist between runs.
Isolation
- Jobs are isolated from each other to prevent cross-job interference.
Reliability
- Runner infrastructure is distributed across multiple Availability Zones (AZs) to ensure high availability.
Runner versions
Section titled “Runner versions”STACKIT runners follow the latest stable Forgejo runner releases.
- Current runner version: Forgejo Runner v11
New versions are adopted after validation to ensure compatibility and stability.
Planned platform support
Section titled “Planned platform support”Additional runner environments are planned to extend platform compatibility.
- Windows runners – planned for Q3 2026
- macOS runners – currently under evaluation