Skip to content

Commit b0eaf8d

Browse files
committed
docs: clarify community vs enterprise tiers and add maintained actions section
1 parent 063e8e3 commit b0eaf8d

1 file changed

Lines changed: 39 additions & 13 deletions

File tree

‎README.md‎

Lines changed: 39 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,8 @@ Harden-Runner secures over **25 million CI/CD workflow runs every week**, protec
4040
## Quick Links
4141
- [Getting Started Guide](#getting-started)
4242
- [Why Choose Harden-Runner](#why-choose-harden-runner)
43-
- [Features and Capabilities](#features)
43+
- [Features and Pricing Tiers](#features-and-pricing-tiers)
44+
- [StepSecurity Maintained Actions (Free for Public Repos)](#stepsecurity-maintained-actions)
4445
- [Case Studies and Trusted Projects](#trusted-by-and-case-studies)
4546
- [Environment Compatibility Matrix](#environment-compatibility-matrix)
4647
- [How It Works](docs/how-it-works.md)
@@ -63,6 +64,9 @@ Learn how Harden-Runner works through the video below, which shows how it detect
6364

6465
This guide walks you through the steps to set up and use Harden-Runner in your CI/CD workflows. For more details, refer to the [official documentation](https://docs.stepsecurity.io/harden-runner).
6566

67+
> [!NOTE]
68+
> The Community tier is free for **public repositories on GitHub-hosted runners** and includes the core feature set. Advanced features, private repositories, and self-hosted runners (including ARC) require the Enterprise tier. See [Features and Pricing Tiers](#features-and-pricing-tiers) for what is in each tier.
69+
6670
### **Step 1: Add Harden-Runner to Your Workflow**
6771

6872
To integrate Harden-Runner, follow these steps:
@@ -108,12 +112,23 @@ Run your workflow. Once completed:
108112

109113
---
110114

111-
## Features
115+
## Features and Pricing Tiers
116+
117+
Harden-Runner offers a comprehensive suite of features to enhance the security of your CI/CD workflows, available in two tiers: **Community** (free) and **Enterprise** (paid). Two things determine what you get: **where your workflows run** decides whether the free tier is available at all, and **your tier** decides which features you get. The feature lists below show what is in each tier.
118+
119+
| Where your workflows run | What's available |
120+
|--------------------------|------------------|
121+
| Public repositories on GitHub-hosted runners | **Community** features free; **Enterprise** features require a paid plan |
122+
| Private repositories (any runner type) | **Enterprise** (paid) only |
123+
| Self-hosted runners, including ARC and bare metal (public or private repositories) | **Enterprise** (paid) only |
112124

113-
Harden-Runner offers a comprehensive suite of features to enhance the security of your CI/CD workflows, available in two tiers: **Community** (Free) and **Enterprise** (Paid).
125+
> [!IMPORTANT]
126+
> **Self-hosted runners require an Enterprise subscription, even for public repositories.** Without a subscription, the Harden-Runner action is a no-op on self-hosted runners: the step succeeds and your workflow passes, but nothing is monitored and no insights are generated. To enable Harden-Runner on your self-hosted runners, [start a free trial](https://www.stepsecurity.io/start-free).
114127

115128
### Community (Free)
116129

130+
Available for public repositories running on GitHub-hosted runners:
131+
117132
- **CI/CD-Aware Event Correlation:** Each outbound network connection, file operation, and process execution is mapped to the exact step, job, and workflow where it occurs.
118133
- **Automated Baseline Creation:** Harden-Runner builds a baseline for each job based on past outbound network connections.
119134
- **Anomaly Detection:** Once the baseline is created, any future outbound calls not in the baseline trigger a detection.
@@ -126,8 +141,8 @@ Harden-Runner offers a comprehensive suite of features to enhance the security o
126141
Includes all features in the **Community** tier, plus:
127142

128143
- **Support for Private Repositories:** Extend Harden-Runner's security capabilities to your private GitHub repositories.
129-
- **Support for Self-Hosted Runners:** Apply security controls and monitoring to self-hosted GitHub Actions runners.
130-
- **GitHub Checks Integration:** Enable GitHub Checks for Harden-Runner—if the baseline remains unchanged, the check passes; if it changes, the check fails, showing new outbound connections.
144+
- **Support for Self-Hosted Runners:** Apply security controls and monitoring to self-hosted GitHub Actions runners (VM, bare metal, and ARC), for both public and private repositories.
145+
- **GitHub Checks Integration:** Enable GitHub Checks for Harden-Runner. If the baseline remains unchanged, the check passes; if it changes, the check fails, showing new outbound connections.
131146
- **View Outbound GitHub API calls at the Job Level:** Monitor HTTPS requests to GitHub APIs
132147
- **Determine Minimum GITHUB_TOKEN Permissions:** Monitor outbound HTTPS requests to GitHub APIs to recommend the least-privilege permissions needed for your workflows, enhancing security by reducing unnecessary access.
133148
- **View the Name and Path of Every File Written During the Build Process:** Gain visibility into every file written to the build environment, including the ability to correlate file writes with processes, ensuring complete transparency.
@@ -139,6 +154,17 @@ Explore the full feature set in the [Features Documentation](https://docs.stepse
139154

140155
---
141156

157+
## StepSecurity Maintained Actions
158+
159+
Many popular third-party GitHub Actions are abandoned, maintained by a single person, or stuck on outdated runtimes. StepSecurity publishes [Maintained Actions](https://docs.stepsecurity.io/github-actions/actions/stepsecurity-maintained-actions): drop-in replacements that are actively maintained, security-reviewed, and kept current, including updates to the Node 24 runtime.
160+
161+
- **Free for public repositories**, no subscription required. Read the [announcement](https://www.stepsecurity.io/blog/stepsecurity-maintained-actions-are-now-free-for-public-repos).
162+
- **~500 actions and growing.** [Browse the full catalog](https://app.stepsecurity.io/action-advisor?tab=maintained).
163+
- **Actively maintained:** dependency updates, runtime upgrades (such as Node 24), and defined SLAs for patching vulnerabilities.
164+
- **Hardened release process:** manual secure code review before onboarding, signed commits, mandatory peer review, and tag protection.
165+
166+
---
167+
142168
## Trusted By and Case Studies
143169

144170
Harden-Runner is trusted by over 11,000 leading open-source projects and enterprises, including Microsoft, Google, Kubernetes, and more.
@@ -164,14 +190,14 @@ Harden-Runner is trusted by over 11,000 leading open-source projects and enterpr
164190

165191
Harden-Runner is designed to work seamlessly across a variety of runner environments, providing consistent security insights and protections regardless of where your workflows execute. For self-hosted runners, audit mode is deployed directly to the runner infrastructure without requiring any changes to your existing workflows. For more details, refer to the [official documentation](https://docs.stepsecurity.io/harden-runner).
166192

167-
| Environment Type | Compatibility | Audit Mode Deployment | Workflow Changes for Audit/Block Mode |
168-
|------------------|---------------|--------------------------|-------------------|
169-
| GitHub-hosted runners (Linux) | ✅ Full support | Add Harden-Runner Action to workflow | Yes |
170-
| GitHub-hosted runners (Windows, macOS) | ✅ Audit mode only | Add Harden-Runner Action to workflow | Yes |
171-
| Self-hosted VM runners | ✅ Full support | Include agent in runner image | No |
172-
| Self-hosted bare-metal runners | ✅ Full support | Install agent as a service | No |
173-
| Actions Runner Controller (ARC) | ✅ Full support | Deploy as DaemonSet | No |
174-
| RunsOn Runners | ✅ Full support | Pre-integrated | No |
193+
| Environment Type | Compatibility | Audit Mode Deployment | Workflow Changes for Audit/Block Mode | Free Community Tier |
194+
|------------------|---------------|--------------------------|-------------------|---------------------|
195+
| GitHub-hosted runners (Linux) | ✅ Full support | Add Harden-Runner Action to workflow | Yes | ✅ Public repos ([Community features](#community-free) only) |
196+
| GitHub-hosted runners (Windows, macOS) | ✅ Audit mode only | Add Harden-Runner Action to workflow | Yes | ✅ Public repos ([Community features](#community-free) only) |
197+
| Self-hosted VM runners | ✅ Full support | Include agent in runner image | No | ❌ Enterprise subscription required |
198+
| Self-hosted bare-metal runners | ✅ Full support | Install agent as a service | No | ❌ Enterprise subscription required |
199+
| Actions Runner Controller (ARC) | ✅ Full support | Deploy as DaemonSet | No | ❌ Enterprise subscription required |
200+
| RunsOn Runners | ✅ Full support | Pre-integrated | No | ❌ Enterprise subscription required |
175201

176202
## How It Works
177203

0 commit comments

Comments
 (0)