Configuration
Label Reference
Complete specification of StarSling runner labels
StarSling uses structured labels to specify runner configuration. The numeric suffix on each label indicates the vCPU count (e.g. -8 = 8 vCPU). The label without a suffix is the 4 vCPU default.
StarSling Labels
| Label | OS | vCPU | Memory | Price per minute |
|---|---|---|---|---|
starsling-ubuntu-24.04-2 | Ubuntu 24.04 | 2 | 8 GB | $0.004 |
starsling-ubuntu-24.04 | Ubuntu 24.04 | 4 | 16 GB | $0.008 |
starsling-ubuntu-24.04-8 | Ubuntu 24.04 | 8 | 32 GB | $0.016 |
starsling-ubuntu-24.04-16 | Ubuntu 24.04 | 16 | 64 GB | $0.032 |
starsling-ubuntu-24.04-32 | Ubuntu 24.04 | 32 | 128 GB | $0.064 |
starsling-ubuntu-24.04-64 | Ubuntu 24.04 | 64 | 256 GB | $0.128 |
GitHub Label Mapping
The default starsling-ubuntu-24.04 (4 vCPU / 16 GB) replaces these GitHub-hosted runner labels:
| GitHub-hosted Label | StarSling Label |
|---|---|
ubuntu-latest | starsling-ubuntu-24.04 |
ubuntu-24.04 | starsling-ubuntu-24.04 |
For larger workloads, opt into a bigger size by appending the vCPU suffix (e.g. starsling-ubuntu-24.04-8). For cost-sensitive or lightweight jobs, use the 2 vCPU starsling-ubuntu-24.04-2 label.
Examples
Basic Usage
jobs:
build:
runs-on: starsling-ubuntu-24.04Drop-in Replacement
jobs:
build:
# Before: runs-on: ubuntu-latest
runs-on: starsling-ubuntu-24.04Larger Size
jobs:
build:
runs-on: starsling-ubuntu-24.04-8Invalid Labels
These will fail to match a runner:
| Invalid Label | Reason |
|---|---|
starsling-ubuntu-22.04 | Only Ubuntu 24.04 is supported |
starsling/ubuntu-24.04 | Use hyphens, not slashes |
starsling-ubuntu-latest | Use starsling-ubuntu-24.04 |