QuickStart
Set up the Monk CI GitHub integration and migrate your workflows in minutes.
Estimated setup time: ~5 minutes
Works with any existing GitHub Actions workflow
Requirements
GitHub Organizations Only
Monk CI currently supports GitHub organizations. Personal repositories and other Git providers are not yet supported.
Migration
Migrate your existing workflows to high-performance infrastructure in under five minutes.
Setting Up Monk CI for Your Organization:
Organization Authorization (Owner Only): The Organization Owner must first install and authorize the Monk CI Github App. This grants the necessary permissions to manage runners for your infrastructure.
Select Repositories: During the installation, the Owner must specify which repositories are allowed to use Monk CI runners. You can select Specific repositories to ensure tight security and cost control.
Members Login: Once the Organization is authorized, team members can visit portal-beta.monkci.com and click Continue with GitHub.
OAuth Authorization: Members must authorize the Monk CI OAuth app to sync their account. Your organization memberships and permitted repositories will be imported automatically.
SAML SSO Verification: If your organization enforces SAML SSO on GitHub, members must complete the SSO prompt during login. Monk CI fully supports GitHub Enterprise Cloud SSO flows to maintain your security policy.
Open your workflow file
Locate the workflow you want to migrate inside .github/workflows/.
Replace the runs-on value
Update each job's runs-on field from the GitHub-hosted runner to a Monk CI tag:
jobs:
build:
# Before
# runs-on: ubuntu-latest
# After
runs-on: monkci-ubuntu-24.04-4Update Every Job
Workflow files can contain multiple jobs. Make sure you replace all runs-on fields - not just the first one.
Choose the right runner size
Pick a tag based on your build's CPU and memory requirements:
| Tag | vCPU | RAM | OS |
|---|---|---|---|
monkci-ubuntu-24.04-2 | 2 | 7 GB | Ubuntu 24.04 |
monkci-ubuntu-24.04-4 | 4 | 15 GB | Ubuntu 24.04 |
monkci-ubuntu-24.04-8 | 8 | 31 GB | Ubuntu 24.04 |
monkci-ubuntu-24.04-16 | 16 | 62 GB | Ubuntu 24.04 |
Not sure which size to pick? Start with monkci-ubuntu-24.04-4 - it matches the default GitHub-hosted runner and works for most CI workloads.
Commit and push
Save the file and push your changes. The next workflow run will use the Monk CI runner automatically.
Observability
When builds break at 2 AM, you need answers - not guesswork. Monk CI gives your team full-stack visibility into every run, every log line, and every test result.
Run History
Browse, search, and drill into any past CI run. Filter by Repository, workflow, author, status, and trigger to surface patterns fast.
Analytics Page
Visualize CI performance with job trends, failure rates, and runtime insights. Filter by repository, status, user, and runner to quickly identify bottleneck and reliability issues.
Cache Page
View and manage workflow cache entries by repository. Monitor cache usage, identify stale data, and delete entries to reclaim space and optimise CI performance.
Usage & Billing
Track CI usage, spending and job minutes in real time. Monitor trends view invoices, and manage billing settings to stay in control of costs.
Test Intelligence (Coming Soon!)
Automatically detect flaky tests, track failure trends over time, and surface the exact commits that introduced regressions.
Need help with your migration?
Our team responds within one business day.