/

Pipelines and runners

Self-hosted runners

Run jobs on your own machines and route them with labels. Public beta.

updated

Oct 14, 2026

//

6 min read

A self-hosted runner is a small agent that connects out to Cinder and waits for jobs.

Register a runner

$ cinder runner register --token $TOKEN --label gpu
$ cinder runner register --token $TOKEN --label gpu
$ cinder runner register --token $TOKEN --label gpu

The agent needs outbound HTTPS only. No inbound ports are opened.

Route jobs

steps:
  - run: ./train.sh
    runs-on: gpu
steps:
  - run: ./train.sh
    runs-on: gpu
steps:
  - run: ./train.sh
    runs-on: gpu

Security

  • Run the agent as an unprivileged user.

  • Do not use self-hosted runners for public repositories you do not control.

  • Runners update themselves. Pin a version in Settings if you need to hold back.

Still stuck? Try our AI support

Ask in plain words and get an answer from the docs. AI support by Chatbase, partner link.

Create a free website with Framer, the website builder loved by startups, designers and agencies.