A GitHub Runner running on Zerops, using the built-in zCLI binary for deployments directly from your CI/CD pipelines.
You can manually copy the import yaml into the import dialog in the Zerops app.
- Ubuntu 26.04 base with GitHub Runner installed via official binary
- zCLI available out of the box for Zerops deployments from your pipelines
- Shell executor for full control over the build environment
- Fixed container count — runners shouldn't scale horizontally automatically (adjust as needed)
- Health check by checking the runner process
Set the following environment variables in the import yaml before importing:
| Variable | Description |
|---|---|
GITLAB_URL |
URL of your GitHub instance (e.g. https://github.com/) |
GITLAB_TOKEN |
Runner authentication token from GitHub |
GITHUB_REPO |
Repository for which the GitHub Runner is registered |
RUNNER_LABELS |
Custom labels to identify the runner |
If your GitHub instance uses an IP blocklist, create the project first, allow its IP address in your GitHub settings, then import the
zclirunnerservice.
To adjust capacity for production workloads, increase minContainers/maxContainers and allocate more CPU/RAM to the service.
- Add zerops.yml to the repository
- Install runner dependencies (
git,zip,gcc,bzr,make,jq) inprepareCommands - Download and install the GitHub Runner binary in
prepareCommands - Register the runner automatically on startup via
initCommands - Configure a health check by checking the runner process status
Need help setting your project up? Join Zerops Discord community.