Skip to content
2 min read

Runners

Managed runners are the compute that executes your Actions workflows. Fjord registers and operates them for you; you do not stand up or maintain runner machines.

Every plan includes the shared runner pool, so managed CI works on Starter, Team, and Pro. Nothing dedicated is included at any tier. A dedicated, single-tenant Linux runner is a paid add-on on top of your plan, priced per runner and billed monthly.

Runners by tier

TierShared runner poolDedicated Linux runner add-on
StarterIncludedNot offered on this plan
TeamIncludedUp to 1, at $29/mo per runner
ProIncludedUp to 3, at $29/mo each

The add-on is optional: leave it off and you pay the plan price and nothing more. The per-tier number is a cap, the maximum quantity a plan may attach, not an allowance and not something you receive by default. Add runners when you deploy an instance, or from the billing portal afterwards. The rate card at fjord.sh carries the current add-on price and is the source of truth for it.

Dedicated runners are unmetered: they are not billed by the CI minute, and they are registered to your instance rather than shared with other instances.

Runners come online with your instance; there is nothing to install. They are ephemeral, each job gets a clean environment, and they reach Fjord’s Actions by full URL so workflows never depend on github.com.

Check runner status

The instance dashboard shows the runner pool for your instance, including how many runners are registered and how many are currently busy, so you can see at a glance whether jobs are queuing. If you have attached the add-on, the runner autoscaling runbook covers how a dedicated pool scales to demand and back to zero.

Use them in a workflow

Target the Linux runners with runs-on: ubuntu-latest and reference Fjord Actions by full URL:

.forgejo/workflows/ci.yml
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: https://rasterhub.com/rasterstate/setup-node-action@v1
        with:
          node-version: '20'
      - run: npm ci && npm test

The Actions overview covers the full drop-in bundle: cache, artifacts, language toolchains, Docker, and repository automation. To run jobs on a schedule, on push, or on demand, use

standard Forgejo workflow triggers.
Tip

Want capacity that is yours alone? Add dedicated Linux runners on Team (up to one) or Pro (up to three) for $29/mo each. See Plans and billing.

Contributors
  • Stephen Way