Label Reference

StarSling uses structured labels to specify runner configuration. A label is a base runner name, optionally followed by / and a configuration selector:

starsling-ubuntu-24.04-gpu/gpus=rtx-5090:1
└────── base label ──────┘ └─ selector ──┘

The numeric suffix on a base label indicates the vCPU count (e.g. -8 = 8 vCPU). The label without a suffix is the 4 vCPU default. Selectors are used by GPU runners to choose a card; CPU runners take no selector.

StarSling Labels

GPU Labels

GPU runners use the starsling-ubuntu-24.04-gpu base label and run Ubuntu 24.04 like every other size.

The gpus selector

gpus=<sku>:<count> chooses the card and how many of them. The SKU is one of:

While GPU runners are in beta they are single-card, so <count> is always 1.

The bare starsling-ubuntu-24.04-gpu label carries no selector and is equivalent to starsling-ubuntu-24.04-gpu/gpus=rtx-pro-6000:1.

See Compute Specifications for pricing details.

GitHub Label Mapping

The default starsling-ubuntu-24.04 (4 vCPU / 16 GB) replaces these GitHub-hosted runner labels:

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.04

Drop-in Replacement

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

Larger Size

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

GPU Runner

jobs:
  train:
    runs-on: starsling-ubuntu-24.04-gpu

Specific GPU Card

jobs:
  train:
    runs-on: starsling-ubuntu-24.04-gpu/gpus=rtx-5090:1

Invalid Labels

These will fail to match a runner: