Repository navigation
RunR 0.6.9
RunR is an open-source, self-hosted serverless platform on Kubernetes and Knative: functions, containers, sandboxes, WebAssembly and durable workflows, with an API, a web console, the runr CLI, SDKs, a Terraform provider and a GitHub Action. You install it on infrastructure you operate, connected or air-gapped. It is developed by BRF Teknoloji and released under the MIT License.
0.6.9 lets the dependency test bot release what passes. Each new version of a package RunR ships or builds with (the region charts and Knative, the API's Composer packages, the npm packages of the console and the SDKs, the Go modules, the GitHub Actions pins, the Dockerfiles' base images and the tool pins) is tested on the last release, and the versions whose suites pass become one patch release per run, with a signed tag, the images, the GitHub release and the chart on helm.brf.sh; bumps that ship nothing land on the development branch and come with the next release (docs/development.md). In a pay-as-you-go region a stopped project gives its capacity back and is admitted again when it is resumed; a fixed region lends a stopped project's allocation to its organization's other projects there. Region → Workers → Capacity shows what the region would need with every stopped project back, the capacity alarm tells the region's provider when that would run short, and a resumed project that waits for room says why on its page; the in-app tutorial has a tour of the card. Builds try a failed pull through the region registry again, a region's setup survives a GitHub 5xx, and the Kind and UI e2e run on GitHub-hosted runners.
Two database migrations, which only add a column. Nothing has to be set. A region with many stopped projects can raise the capacity alarm right after the upgrade.
Install
- Kubernetes (Helm): the chart comes from BRF's public Helm repository, without credentials:
See the README and docs/install.md;
helm repo add brf-tech https://helm.brf.sh helm upgrade --install runr brf-tech/runr --namespace runr --create-namespace --set domain=runr.example.com
helm show values brf-tech/runrlists every value. A pinned install adds--version 0.6.9; the API and UI images, the region agent and the event gateway follow the chart version. - Single host (Docker Compose, also air-gapped): compose/README.md, from a checkout of the release tag (
git clone -b v0.6.9 https://github.com/BRF-Tech/runr.git). - CLI:
curl -fsSL https://runr.sh/install.sh | shon Linux and macOS. The archives of every platform are at runr.sh/dl (https://runr.sh/dl/cli/v0.6.9/) and attached below; check them againstchecksums.txt(docs/cli.md#install). - Terraform / OpenTofu:
source = "brf-tech/runr",version = "~> 0.6", from the Terraform Registry;terraform initchecks the archive againstSHA256SUMS, signed with the RunR release key (key ID2588846B241BC095). runr.sh serves the same archives underrunr.sh/brf-tech/runr, for OpenTofu and for configurations that use that address (docs/terraform.md#install). - GitHub Action:
uses: brf-tech/runr/actions/deploy@v0.6.9; it downloads the CLI from runr.sh (docs/github-action.md). - Images: every image is published under
ghcr.io/brf-tech/runrby release-images.yml, for linux/amd64 and linux/arm64, and pulls anonymously.
The documentation is at runr.sh/docs and in the documentation index here.
Upgrading from 0.6.8
Upgrade in place with helm upgrade of the running release; never uninstall and install again, and back up the database first (Procedure in docs/upgrade.md). From 0.6.8 the images keep their names and nothing has to be set (0.6.8 → 0.6.9).
helm repo update brf-tech
helm upgrade runr brf-tech/runr --version 0.6.9 -n runr --reuse-values- Two migrations, which only add.
2026_11_11_100001_add_capacity_released_at_to_projectsadds the nullableprojects.capacity_released_at, and a multi-tenant installation adds it to every tenant schema (0111_add_capacity_released_at_to_projects); existing projects keep what they have. - Stopped projects give their capacity back at once. In a pay-as-you-go region (every region while billing is off), the projects that are stopped at the upgrade count neither in the region's budgets nor in their organization's quota once 0.6.9 runs. Their resume admits them again: when the region or the quota has no room, the resume answers without a deployment (
redeploy_code: capacity_exceededorquota_exceeded), the project holds nothing until a deploy of it fits, and its page shows why it waits (capacity_waiting). A fixed region keeps the reservation, bills the allocation and lends its share to the organization's running projects there (Stopped projects give their capacity back). - The capacity alarm also watches the stopped projects. When the region with every stopped project back would cross 60 % or 80 %, its provider is told how much capacity to add (
resource_threshold,data.basis: "with_stopped"), in the app, by mail and to the alert rules. The check runs every minute: look at Workers → Capacity → With stopped projects (GET /api/knative-regions/{id}/capacity→with_stopped) before the upgrade (The capacity alarm with stopped projects). - Multi-tenant installations: an organization's own region alarms the organization. Its owners and admins see the capacity alarm and get the mail; the platform administrators no longer get that mail. A platform region's alarm also counts the platform's own projects, and every capacity alarm mail honours the recipient's
resource_thresholdmail preference (Capacity alarm recipients). - Builds and region setups retry. Kaniko tries a failed registry operation up to five more times; the region registry's
ghcr.ioupstream getsmaxRetriesandretryDelaywith the next changeregion:reconcilemakes to its config.json (the upgrade does not restart Zot for it); the charts and CRDs a region downloads from GitHub are fetched again on a 5xx (Build and registry retries). - The region agent and the event gateway move to 0.6.9. As in 0.6.0 to 0.6.8, after
helm upgradereturned, the Jobrunr-region-reconcile-<revision>moves the regions' agents, queue consumers and topic publishers toghcr.io/brf-tech/runr/agent:0.6.9andqueue-consumer:0.6.9; each rolls once. A region that pulls through a mirror of its own needs these two images there before the upgrade (Order of operations). Nothing else in the regions moves. - Back to 0.6.8: a
helm rollbackon the same database; do not roll the migrations back. 0.6.8 ignores the column and counts stopped projects in their regions again. After going to 0.6.9 again, deploy once each project that was resumed on 0.6.9 and deployed on 0.6.8 (Back to 0.6.8). - Terraform provider 0.6.9: its resources and data sources are the ones of 0.6.8.
From 0.6.7, upgrade straight to 0.6.9 and read 0.6.7 → 0.6.8 as well: 0.6.8 adds runtime sources and RunR's signed runtime catalog, which the API reads from ghcr.io (runtimeCatalog.offline: true keeps the bundled one), gives single-tenant Owners platform.manage, moves the region Traefik to chart 42.3.1, and a marketplace that merges the package's default values into an upgrade can bring ingress.tls.mode: letsencrypt to a release that never set it (The console certificate warning). From 0.6.6, also read 0.6.6 → 0.6.7: 0.6.7 changes how sandbox commands travel on Kata and gVisor (a command on gVisor takes about 100 ms more), input that arrives short fails, and a custom sandbox image needs cat and mkfifo. From 0.6.5, also read 0.6.5 → 0.6.6: 0.6.6 re-runs kata-deploy with Kata Containers 4.3.1, which stops the running Kata pods of every region with Kata, the region Traefik moves to chart 42.3.0 and deletes request headers with _ or . in their names, and Reverb refuses client events. From 0.6.4, also read 0.6.4 → 0.6.5: 0.6.5 adds the notification_user_states migration, the Helm value notifications.retentionDays, and its daily task deletes notifications older than 90 days. From 0.6.3, also read 0.6.3 → 0.6.4: 0.6.4 adds the captcha_settings migration and the Helm values captcha.*, and its first upgrade rolls the pods once. From 0.6.2, also read 0.6.2 → 0.6.3; from 0.6.1, also 0.6.1 → 0.6.2. From 0.6.0, also read 0.6.0 → 0.6.1 first: before a rollback to 0.6.0, let the running deploys finish (Rolling back to 0.6.0). From 0.5.10, read 0.5.10 → 0.6.0 in docs/upgrade.md first — in particular what to decide before the upgrade — and the notes of 0.6.0 to 0.6.8 in CHANGELOG.md; everything said there applies. From 0.5.9 or earlier, read the notes of the releases in between as well; from 0.5.8 or earlier, add --set api.image.tag= --set ui.image.tag= to that upgrade once (step 3 of the Procedure).
Changes in 0.6.9 (2026-11-12)
Upgrade notes
- Two migrations add one column (
2026_11_11_100001_add_capacity_released_at_to_projects, and on a
multi-tenant installation0111_add_capacity_released_at_to_projectsin every tenant schema): the
nullableprojects.capacity_released_at, set by a resume until a deploy admits the project again.
Existing projects keep what they have (0.6.8 → 0.6.9 in upgrade.md). - The projects that are stopped at the upgrade give their capacity back at once in a
pay-as-you-go region (every region while billing is off): they count neither in the region's
budgets nor in their organization's quota, and their resume has to fit again. A fixed region
keeps their reservation and lends their share
(Stopped projects give their capacity back). - A region with many stopped projects can alarm right after the upgrade: the capacity alarm now
also watches what the region would need with every stopped project back
(data.basis: "with_stopped"), checked every minute. Look at Region → Workers → Capacity first
(The capacity alarm with stopped projects). - Multi-tenant: the capacity alarm of an organization's own region goes to its owners and admins;
the platform administrators no longer get its mail. Every capacity alarm mail honours the
recipient'sresource_thresholdmail preference. - The region registry's
ghcr.ioretries (maxRetries: 5,retryDelay: 2s) reach a registry set
up by an earlier release with the next changeregion:reconcilemakes to its config.json, or with
registry:upgrade-zot; the upgrade does not restart Zot for them. - Back to 0.6.8 is a
helm rollbackwithout rolling the migrations back
(Back to 0.6.8). 0.6.8 ignores the column and counts stopped
projects again. After upgrading to 0.6.9 again, deploy once each project that was resumed on 0.6.9
and deployed on 0.6.8: until then it counts as released.
Added
- The dependency test bot releases what passes. Each new version of a region dependency that the
daily release check filed an issue for is now moved and tested on the last release, not on the
development branch, and the versions whose suites pass become one patch release per run: the
chart's version, the docs' pins, its changelog section and upgrade notes with every version's
line, a signed tag, the images that release-images.yml builds (checked against the registry
without credentials, digest by digest), the GitHub release and the chart on helm.brf.sh; the
development branch takes the release as a merge, so nothing unfinished ships and the next release
carries it. The green versions of a run are made again together on the last release and, two or
more, tested together; one that does not go with the others needs a person, and the ones after it
wait for the next run, while the ones before it are released. A red suite, a bump that is not
mechanical or a release step that fails stops with a comment on the issue that says what was
done, and a red version never holds up the green ones; a release that stopped goes on with the
workflow'sresume, anddry_runmakes and checks everything without pushing. A dependency
release ships the chart and the images: the CLI, the Terraform provider and runr.sh stay those of
the last full release. A suite whose script ends 0 while its results count failed tests is red.
See docs/development.md. - The dependency test bot follows every package RunR ships or builds with. Besides the region
charts and Knative, the daily check now reads the API's Composer packages, the npm packages of the
console and the SDKs, the Go modules of the region images, the CLI, the Terraform provider and the
dev tunnel, the GitHub Actions pins and the Dockerfiles' base images. The minor and patch updates
of one group are one issue and one bump; a new major, an exact pin or a new toolchain is an issue
of its own that a person decides, and a security advisory makes the group's issue urgent (tested
the same day). Packages pinned on purpose stay where they are, with their reason
(ci/deps/holds.txt). A bump that changes what a release ships (an image, the chart, the API's
code) goes into the run's patch release as before; a gateway-auth, image-upload, supply-chain or
Spin shim image that changes gets a patch version of its own. The ones that ship nothing (test
tooling, the CLI's and the provider's modules, the Actions pins) land on the development branch
together, in one push per run, and come with the next release. A bump whose lockfile does not
come out the same twice, or that would move a constraint, goes to a person. It also follows the
tool pins of the images and the workflows (helm, kubectl, Scalar, syft, cosign, oras, kind,
cloud-provider-kind, kubeconform, crane, actionlint, gitleaks, Terraform, govulncheck) and moves
their published checksums with them (an image's in the run's patch release, a workflow's on the
development branch), files new lines of the toolchains and every release of the patched Spin
shim for a person, and follows the Python SDKs and the examples (npm, Go, PyPI, Cargo,
Dockerfiles). The bot's commits and tags now carry the identity of RunR's public history and a
RunR-Deps-Bottrailer, and CI skips their pushes. See
docs/development.md. - The console's checks are shared workflows. Its lint, unit tests and build (
ui-tests.yml) and
its dev-stack suite (ui-stack-suite.yml) are reusable workflows that CI, the weekly E2E run and
the dependency test bot call. Their result comes from Vitest's and Playwright's JSON reports, so
CI also fails when the in-app tutorial's spec did not run. CI now tests the Python SDKs and the
Node Sandbox SDK, and the bot tests the Python SDKs. The API checks count PHPUnit's failures from
its summary line, so a green run is no longer read as failed. - A region shows, and alarms on, what it would need with its stopped projects back. Region →
Workers → Capacity shows next to the budgets what the region would need if every stopped project
were resumed at the same time: what they add per resource, how full the fuller budget would be,
by how much it would be exceeded and the capacity that keeps it under the alarm's level, with the
largest stopped projects (GET /api/knative-regions/{id}/capacity→with_stopped). When this
figure crosses the capacity alarm's levels (60 % warning, 80 % critical), the people who get the
capacity alarm today are told to add nodes — by how much the region would be exceeded, how much
to add, and which stopped projects need how much in total — in the app, by mail and through the
resource_thresholdalert rules (data.basis: "with_stopped", its own hourly cooldown). The
card's ? starts a tour of it. On a multi-tenant installation the card shows what the alarm
measures: a platform region adds up every tenant's and the platform's own projects. See
docs/architecture.md.
Changed
- A stopped project gives its capacity back in a pay-as-you-go region. Its reservation — its
own workload and its environments — no longer counts in the region's budgets, nor in its
organization's quota, so others can use the room. A resume admits it again: when the region (or
the quota) has no room, the redeploy is refused withcapacity_exceeded(quota_exceeded) and
the project is resumed without a deployment, holding nothing until a deploy of it fits; a git
push or console deploy of it is refused the same way (422). The project page shows a banner
while it waits: why (capacity_exceeded,quota_exceeded,fixed_allocation_exceeded), what
each resource lacks and what to do — the project resource's newcapacity_waiting. A region
whose billing is off counts as pay as you go. See
docs/billing.md. - The capacity alarm of an organization's own region goes to the organization. Its members who
manage its regions (owners and admins) see it in the app and get the mail; the platform
administrators no longer get its mail. Every capacity alarm mail honours the recipient's
resource_thresholdmail preference, and a platform region's alarm also counts the platform's
own projects. - A fixed region's allocations cover the projects that run. A stopped project keeps its
reservation and its allocation stays billed, but its share is lent to its organization's other
projects in the region: they may run beyond their own allocation up to what the stopped projects
lend and no other project uses yet; a running project's own allocation is always its own. The two
cannot run at the same time: the stopped project's resume has to fit its allocation minus what
the others still use of the lent shares, else it is refused withfixed_allocation_exceeded,
like a deploy. See docs/billing.md. - The Kind e2e plans its waves with the stopped projects back, so a case that stops a project
and resumes it later finds its room free.
Fixed
- The Kind e2e fits a GitHub-hosted runner again. It runs its cases in waves the region runs at
once and deletes each wave's projects once they are verified: since 0.6.8's runtimes it had kept
every case's project, filled the region's FaaS overcommit budget and refused the later creates. A
shell wake-up that fails names what holds the pod. - The UI e2e of the dev stack runs on GitHub-hosted runners. The new
vue-initand
vendor-initservices createvue/node_modulesandapi/vendor, where the containers' package
volumes are mounted, owned like the checkout: Docker made them root's, sonpm cion the runner
(andnpm ciorcomposer installon a Linux host) failed with EACCES. - A model service starts on a region whose Knative features were just turned on. When
Knative's webhook refuses the model service's Knative Service for a pod-spec feature it has not
seen yet (persistent volume claims, a field a feature flag gates), the deploy applies it again up
to six times within about 40 seconds and logs each try; any other refusal still fails at once. - A build no longer fails on the first failed pull through the region registry. Function and
runtime image builds try a failed registry operation (aFROMmanifest, layer unpacking, the
push) up to five more times with backoff instead of ending on one 503 or 404 from Zot (unable to complete operation after 0 attempts), and the registry's ghcr.io upstream retries a failed fetch
(maxRetries: 5,retryDelay: 2s; an installed registry takes it with its next config change). - A GitHub 504 no longer fails a region's setup. The charts a region installs from GitHub
releases (Zot's, and the prometheus-community and grafana charts) and Knative Serving's CRDs are
downloaded again when GitHub answers 5xx or 429 or the connection breaks, four tries in all, 2, 4
and 8 s apart, then once through the GitHub API's asset endpoint; a chart that comes that way is
installed only with the digest its repository's index gives it. Before, one "504 Gateway Timeout"
failed the whole registry setup ("Zot Helm install failed").