From 670075651441008e3ca9d879b72d7f1d0d2c645a Mon Sep 17 00:00:00 2001 From: milldr Date: Fri, 23 Jan 2026 13:25:22 -0500 Subject: [PATCH 1/2] docs: Add RunsOn license acquisition as first setup step - Add license acquisition step with pricing and licensing options - Recommend commercial license for production deployments - Include trial option for evaluation purposes - Add instructions for sharing license key via 1Password - Update quick start checklist to include license acquisition This ensures users are guided to obtain a license before attempting deployment. Co-Authored-By: Claude Haiku 4.5 --- docs/layers/github-actions/runs-on.mdx | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/docs/layers/github-actions/runs-on.mdx b/docs/layers/github-actions/runs-on.mdx index 1181e1d50..309aefe0d 100644 --- a/docs/layers/github-actions/runs-on.mdx +++ b/docs/layers/github-actions/runs-on.mdx @@ -40,6 +40,7 @@ We evaluated multiple self-hosted runner solutions and recommend RunsOn for most +- Acquire a RunsOn license - Vendor the required components - Deploy the RunsOn component - Install the GitHub App @@ -58,6 +59,29 @@ If you opt to deploy RunsOn into a separate VPC, you will need to connect that V + + ## Acquire a RunsOn License + + RunsOn requires a license key to operate. We recommend the **Commercial License** for production deployments. A free 15-day trial is available if you need to evaluate RunsOn first. + + **License Options:** + + | License | Cost | Use Case | + |---------|------|----------| + | [Demo License](https://runs-on.lemonsqueezy.com/checkout/buy/216f5675-ac9d-4668-b6a0-629377f5b770) | Free (15 days) | Evaluation and testing | + | [Commercial License](https://runs-on.lemonsqueezy.com/checkout/buy/f97e3140-ef59-4084-b28b-e55aa2b64b1f) (recommended) | $300/year | Production deployments | + | [Sponsorship License](https://runs-on.lemonsqueezy.com/checkout/buy/f97e3140-ef59-4084-b28b-e55aa2b64b1f) | $1,500/year | Source code access + dedicated support | + + Non-profit organizations qualify for free non-commercial licenses. + + + Share your RunsOn license key via 1Password. We'll add it to your Atmos stack catalog at `stacks/catalog/runs-on/defaults.yaml` in the `LicenseKey` parameter. + + + For more details, see the [RunsOn Pricing](https://runs-on.com/pricing/) page. + + + ## Vendor RunsOn Component From 760c8118af7e78bb40c556473425e3aedac8aea9 Mon Sep 17 00:00:00 2001 From: milldr Date: Fri, 23 Jan 2026 17:30:37 -0500 Subject: [PATCH 2/2] docs: Add RunsOn license instructions to action items pages - Add "Purchase a RunsOn License" section to jumpstart and quickstart action items - Update runs-on setup page with clearer license configuration instructions - Clarify that license key goes in stacks/catalog/runs-on/defaults.yaml - Cloud Posse customers can share via 1Password for assistance Co-Authored-By: Claude Opus 4.5 --- docs/jumpstart/action-items.mdx | 6 ++++++ docs/layers/github-actions/runs-on.mdx | 10 ++++++---- docs/quickstart/action-items.mdx | 6 ++++++ 3 files changed, 18 insertions(+), 4 deletions(-) diff --git a/docs/jumpstart/action-items.mdx b/docs/jumpstart/action-items.mdx index e651e26c2..2567a0abf 100644 --- a/docs/jumpstart/action-items.mdx +++ b/docs/jumpstart/action-items.mdx @@ -86,6 +86,12 @@ Before we can get started, here's the minimum information we need from you. We recommend [Runs On](/layers/github-actions/runs-on/) for self-hosted GitHub runners. It provides zero infrastructure management, simple setup, and cost-effective pricing. +### Purchase a RunsOn License + +RunsOn requires a license to operate. We recommend purchasing the **Commercial License** ($300/year) for production deployments. A free 15-day trial is available if you need to evaluate first. + +Please [purchase a RunsOn license](/layers/github-actions/runs-on/#-acquire-a-runson-license) and share the license key with Cloud Posse via 1Password. + If you have an existing deployment using a legacy approach, see: - [Actions Runner Controller (EKS)](/layers/github-actions/tutorials/eks-github-actions-controller/) - [Philips Labs GitHub Runners](/layers/github-actions/tutorials/philips-labs-github-runners/) diff --git a/docs/layers/github-actions/runs-on.mdx b/docs/layers/github-actions/runs-on.mdx index 309aefe0d..8d3240931 100644 --- a/docs/layers/github-actions/runs-on.mdx +++ b/docs/layers/github-actions/runs-on.mdx @@ -68,14 +68,16 @@ If you opt to deploy RunsOn into a separate VPC, you will need to connect that V | License | Cost | Use Case | |---------|------|----------| - | [Demo License](https://runs-on.lemonsqueezy.com/checkout/buy/216f5675-ac9d-4668-b6a0-629377f5b770) | Free (15 days) | Evaluation and testing | - | [Commercial License](https://runs-on.lemonsqueezy.com/checkout/buy/f97e3140-ef59-4084-b28b-e55aa2b64b1f) (recommended) | $300/year | Production deployments | - | [Sponsorship License](https://runs-on.lemonsqueezy.com/checkout/buy/f97e3140-ef59-4084-b28b-e55aa2b64b1f) | $1,500/year | Source code access + dedicated support | + | Demo | Free (15 days) | Evaluation and testing | + | Commercial (recommended) | $300/year | Production deployments | + | Sponsorship | $1,500/year | Source code access + dedicated support | Non-profit organizations qualify for free non-commercial licenses. + Once you have your license key, add it to your Atmos stack catalog at `stacks/catalog/runs-on/defaults.yaml` in the `LicenseKey` parameter. + - Share your RunsOn license key via 1Password. We'll add it to your Atmos stack catalog at `stacks/catalog/runs-on/defaults.yaml` in the `LicenseKey` parameter. + Share your RunsOn license key via 1Password and we'll add it to your stack catalog for you. For more details, see the [RunsOn Pricing](https://runs-on.com/pricing/) page. diff --git a/docs/quickstart/action-items.mdx b/docs/quickstart/action-items.mdx index 12f5e8ac2..f46607afc 100644 --- a/docs/quickstart/action-items.mdx +++ b/docs/quickstart/action-items.mdx @@ -80,6 +80,12 @@ To get a head start on your infrastructure as code journey, we recommend complet We recommend [Runs On](/layers/github-actions/runs-on/) for self-hosted GitHub runners. It provides zero infrastructure management, simple setup, and cost-effective pricing. +### Purchase a RunsOn License + +RunsOn requires a license to operate. We recommend purchasing the **Commercial License** ($300/year) for production deployments. A free 15-day trial is available if you need to evaluate first. + +See [Acquire a RunsOn License](/layers/github-actions/runs-on/#-acquire-a-runson-license) for details on licensing options. + If you have an existing deployment using a legacy approach, see: - [Actions Runner Controller (EKS)](/layers/github-actions/tutorials/eks-github-actions-controller/) - [Philips Labs GitHub Runners](/layers/github-actions/tutorials/philips-labs-github-runners/)