# Label Reference (/configuration/label-reference)



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

```yaml
jobs:
  build:
    runs-on: starsling-ubuntu-24.04
```

### Drop-in Replacement

```yaml
jobs:
  build:
    # Before: runs-on: ubuntu-latest
    runs-on: starsling-ubuntu-24.04
```

### Larger Size

```yaml
jobs:
  build:
    runs-on: starsling-ubuntu-24.04-8
```

## Invalid 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`   |

<Cards>
  <Card title="Linux Runners" href="/runners/linux-runners" description="Full runner specifications" />

  <Card title="Compute Specifications" href="/runners/compute-sizing" description="Hardware and performance details" />

  <Card title="Migration Guide" href="/configuration/migration-guide" description="Update your workflows" />
</Cards>