Documentation menu
Dashboard & analytics
Managed runners
Team & notifications
Billing & plans
Workflow files
What is on the runner image
The preinstalled toolchain on every Latchkey runner: languages, Docker, browsers, databases, package managers, and the GitHub-compatible toolcache.
In short
- Ubuntu 24.04 with Node, Python, Go, Java, Rust, .NET, and more preinstalled, plus a GitHub-parity toolcache.
- Native Docker with BuildKit, buildx, and compose; QEMU multi-arch builds work out of the box.
- PostgreSQL 16 and MySQL 8.0 are installed with services off at boot; anything missing installs in your job steps.
Every runner boots from a maintained Ubuntu 24.04 LTS (x86_64) image with a toolchain designed to match or exceed GitHub-hosted runners, so most workflows run unchanged.
The toolchain#
| Category | Preinstalled |
|---|---|
| Node.js | 20, 22 (default), 24, with npm and yarn; nvm available |
| Python | 3.10 through 3.13 (3.14 included when available), plus pipx and PyPy |
| Go | 1.22 through 1.25 |
| Java (Temurin) | 8, 11, 17 (default JAVA_HOME), 21, and 25 when available, with Maven, Gradle, and Ant |
| Other languages | Rust (stable + rustfmt + clippy), .NET 8/9/10, Ruby (+ fastlane), PHP 8.3 (+ Composer, Xdebug), Haskell, Swift, Kotlin, Julia, PowerShell |
| Containers | Docker CE with BuildKit, docker buildx, docker compose; Buildah, Podman, Skopeo |
| Browsers | Chrome, Firefox, Edge with matching drivers; Selenium; Android SDK/NDK |
| Databases | PostgreSQL 16, MySQL 8.0 (services disabled at boot; start them in your job) |
| Package managers | Homebrew, conda, vcpkg, plus the language-native ones |
| CLI standards | AWS CLI v2, jq, git, build essentials |
Matching GitHub-hosted behavior#
The most useful property of the image is what you do not have to change. Keep your actions/setup-node, actions/setup-python, and similar steps exactly as they are: they resolve from the GitHub-parity toolcache at /opt/hostedtoolcache instantly instead of downloading, so the same workflow file stays correct on both runner types while you migrate.
Version pinning advice is the same as anywhere else: let the setup actions state the version rather than leaning on image defaults. Node 22 is the default (as on GitHub-hosted Ubuntu 24.04 runners) with 20 and 24 also installed, but a setup-node step with an explicit node-version makes the workflow say what it means, and keeps it stable as the maintained image evolves.
The image's system git configuration sets maintenance.auto to false, so a git fetch starts no background maintenance that a second fetch in the same clone could collide with. GitHub-hosted runners leave it on, and a git command run as git -c maintenance.auto=true fetch turns it back on for that command alone.
Environment variables the image sets#
On the standard Latchkey runner image a GitHub Actions job and a latchkey run job read the same two values from the same runner environment file, so a cargo invocation resolves to the preinstalled toolchain rather than an empty home directory.
| Variable | Value on the standard image |
|---|---|
| CARGO_HOME | /usr/share/rust/.cargo |
| RUSTUP_HOME | /usr/share/rust/.rustup |
Three things worth knowing#
docker buildx build works out of the box for linux/amd64 and linux/arm64.actions/setup-node, setup-python, and friends resolve from /opt/hostedtoolcache instantly, without downloading.Databases and browsers#
PostgreSQL 16 and MySQL 8.0 are preinstalled with their services disabled at boot, so they stay out of the way until a job asks for them. Starting the one you need is a one-line step, and it is standard Ubuntu service management rather than anything Latchkey-specific:
Start the service before the steps that use it:
steps: - uses: actions/checkout@v4 - name: Start PostgreSQL run: sudo systemctl start postgresql - run: npm test
The same pattern for MySQL 8.0:
steps: - uses: actions/checkout@v4 - name: Start MySQL run: sudo systemctl start mysql - run: npm test
Chrome, Firefox, and Edge are preinstalled with matching driver versions, and Selenium is available, so most browser test suites run with no install step at all. For mobile work, the Android SDK and NDK are on the image too.
Starting services inside the job also keeps the dependency explicit: anyone reading the workflow file can see that the suite needs a database, which is worth having when a workflow moves between runner types.
The SSH server and the printing service are also off at boot. A job that needs one starts it in a step: sudo systemctl start ssh for the SSH server, or sudo snap start cups.cupsd for printing.
Q.01What is preinstalled on a Latchkey runner?
Ubuntu 24.04 with Node, Python, Go, Java, Rust, .NET and more, plus a toolcache built for parity with GitHub-hosted runners. Docker is native, with BuildKit, buildx and compose, and QEMU multi-arch builds work without setup.
Q.02Are databases available on the runner?
PostgreSQL 16 and MySQL 8.0 are installed with their services off at boot, so they cost nothing until you start them. Start one in a step when a job needs it, or run a database image as a service container.
Q.03What if a tool my build needs is missing?
Install it in your job steps exactly as you would on a GitHub-hosted runner; the image is a starting point, not a constraint. If the same install runs on every build, that is the signal to move it into a custom runner image instead.