Dockerized self-hosted GitHub Runner

A self-hosted GitHub Actions runner Docker image configured for JKU Racing firmware development.

Pre-installed Tools

This runner includes all tools required for the firmware CI pipeline:

Rust Development

• Rust stable toolchain with rustfmt and clippy
• ESP-IDF Xtensa toolchain for ESP32-S3 development (espup)
• cargo-nextest for fast test execution

Build Tools

• just - Command runner used by the firmware project
• Pkl (v0.29.1) - Apple's configuration language (used by canvas)
• maturin - Build Python wheels from Rust code

Python

• Python 3.12 with development headers
• uv - Fast Python package manager
• python3-cffi - C FFI for Python

Other

• SSH - Pre-configured with GitHub's host keys for private submodule access
• Standard build essentials (build-essential, pkg-config, libssl-dev)

Usage

Environment Variables

Variable	Required	Description
URL	Yes	GitHub repository or organization URL
RUNNER_TOKEN	Yes	Runner registration token from GitHub
RUNNER_NAME	No	Base name for the runner (default: runner)
RUNNER_LABELS	No	Comma-separated labels for the runner

Running with Docker Compose

# Set environment variables
export URL=https://github.com/jkuracing/vehicle-software
export RUNNER_TOKEN=<your-token>

# Start the runner
docker compose up -d