From 1f4b2aa8dad826089ddf4e0819d32ffb46771f84 Mon Sep 17 00:00:00 2001
From: Rae McKelvey <633012+okdistribute@users.noreply.github.com>
Date: Mon, 2 Mar 2026 11:09:30 -0800
Subject: [PATCH 1/3] Add billing section to docs
---
docs.json | 9 +++
iroh-services/billing/control-costs.mdx | 46 +++++++++++++++
iroh-services/billing/faq.mdx | 46 +++++++++++++++
iroh-services/billing/index.mdx | 32 ++++++++++
iroh-services/billing/manage-subscription.mdx | 58 +++++++++++++++++++
5 files changed, 191 insertions(+)
create mode 100644 iroh-services/billing/control-costs.mdx
create mode 100644 iroh-services/billing/faq.mdx
create mode 100644 iroh-services/billing/index.mdx
create mode 100644 iroh-services/billing/manage-subscription.mdx
diff --git a/docs.json b/docs.json
index e2b5411..188fd76 100644
--- a/docs.json
+++ b/docs.json
@@ -107,6 +107,15 @@
{
"group": "Net Diagnostics",
"pages": ["iroh-services/net-diagnostics/quickstart", "iroh-services/net-diagnostics/usage", "iroh-services/net-diagnostics/reports"]
+ },
+ {
+ "group": "Billing",
+ "pages": [
+ "iroh-services/billing/index",
+ "iroh-services/billing/manage-subscription",
+ "iroh-services/billing/control-costs",
+ "iroh-services/billing/faq"
+ ]
}
]
}
diff --git a/iroh-services/billing/control-costs.mdx b/iroh-services/billing/control-costs.mdx
new file mode 100644
index 0000000..5aff173
--- /dev/null
+++ b/iroh-services/billing/control-costs.mdx
@@ -0,0 +1,46 @@
+---
+title: "Control Your Costs"
+description: "Set spend caps and monitor usage to keep your Iroh Services costs predictable"
+---
+
+Iroh Services provides tools to help you stay in control of your spending.
+
+## Spend caps
+
+Spend caps let you set a maximum monthly budget for your project. When your usage reaches the cap, services that incur additional charges will be paused until the next billing cycle.
+
+### Setting a spend cap
+
+1. Go to your project dashboard.
+2. Navigate to **Settings** > **Billing**.
+3. Under **Spend cap**, enter your maximum monthly budget.
+4. Click **Save**.
+
+
+Your spend cap does not include your base plan cost. It only applies to usage-based charges that exceed what's included in your plan.
+
+
+### What happens when you hit your cap
+
+When your usage-based charges reach your spend cap:
+
+- **Metrics ingestion** will be paused. Endpoints will stop sending new metrics until the next billing cycle.
+- **Your existing data** is preserved. Dashboards and historical metrics remain accessible.
+- **Relay connections** are not affected. Your endpoints will continue to connect through relays.
+
+You can raise or remove your spend cap at any time from the billing settings.
+
+## Monitor usage
+
+Track your current usage from the project dashboard:
+
+- **Metrics volume** — the number of metric events ingested this billing cycle.
+- **Endpoint connections** — the number of active connections sending metrics to your project.
+
+Usage resets at the start of each billing cycle.
+
+## Tips for managing costs
+
+- **Start with the Free plan** to understand your usage patterns before upgrading.
+- **Set a spend cap** early to avoid unexpected charges.
+- **Review usage regularly** from the dashboard to spot trends before they become costly.
diff --git a/iroh-services/billing/faq.mdx b/iroh-services/billing/faq.mdx
new file mode 100644
index 0000000..0b4d84a
--- /dev/null
+++ b/iroh-services/billing/faq.mdx
@@ -0,0 +1,46 @@
+---
+title: "Billing FAQ"
+description: "Frequently asked questions about Iroh Services billing"
+---
+
+## What payment methods do you accept?
+
+We accept major credit and debit cards. Payment is processed securely through our payment provider.
+
+## When am I billed?
+
+Billing is monthly. You'll be charged at the beginning of each billing cycle for
+your plan, and at the end of the cycle for any usage-based overages.
+
+## Can I try Iroh Services for free?
+
+Yes. The Free plan gives you access to shared public relays, basic metrics, and
+community support on Discord at no cost.
+
+## What happens if my payment fails?
+
+If a payment fails, we'll retry a few times and notify you by email. If the
+issue isn't resolved, your project may be downgraded to the Free plan.
+
+## Do I get a refund if I cancel mid-cycle?
+
+Relays are billed based on hourly usage, so you'll only be charged for the hours
+you used. For example, if you cancel after 10 hours of relay usage in a month,
+you'll only be billed for those 10 hours. If you have any
+questions about your bill or refunds, please contact us at [support@iroh.computer](mailto:support@iroh.computer).
+
+## How do spend caps work?
+
+Spend caps limit your usage-based charges (not your base plan cost). When you
+hit your cap, usage-based services like metrics ingestion are paused until the
+next cycle. See [Control your costs](/iroh-services/billing/control-costs) for
+details.
+
+## Where can I see my invoices?
+
+Invoices are available in the **Settings** > **Billing** section of your
+[project dashboard](https://n0des.iroh.computer).
+
+## I have a billing question not listed here
+
+Reach out to us at [support@iroh.computer](mailto:support@iroh.computer).
diff --git a/iroh-services/billing/index.mdx b/iroh-services/billing/index.mdx
new file mode 100644
index 0000000..2823a9c
--- /dev/null
+++ b/iroh-services/billing/index.mdx
@@ -0,0 +1,32 @@
+---
+title: "Overview"
+description: "Understand how billing works for Iroh Services"
+---
+
+Iroh Services offers plans to fit your needs, from free tiers for experimentation to enterprise plans for production workloads.
+
+## Plans
+
+| | **Free** | **Pro** | **Enterprise** |
+|---|---|---|---|
+| **Relays** | Shared public relays | Managed dedicated relays | Custom relay configurations |
+| **Metrics** | 1 day retention | 7 day retention | Custom retention & SLAs |
+| **Net Diagnostics** | Community support | Priority support tickets | Guaranteed SLA response times |
+| **Support** | Discord | Email & Discord | Dedicated support & professional services |
+
+For full plan details and pricing, visit the [pricing page](https://n0des.iroh.computer/pricing).
+
+## How billing works
+
+Iroh Services billing is usage-based, calculated monthly. Your bill is determined by:
+
+- **Your plan tier** — each plan includes a base set of features and resource allocations.
+- **Resource usage** — additional charges may apply for usage beyond what's included in your plan, such as metrics volume or relay bandwidth.
+
+Billing is managed through the [Iroh Services dashboard](https://n0des.iroh.computer). You can view your current plan, usage, and invoices at any time.
+
+## Next steps
+
+- [Manage your subscription](/iroh-services/billing/manage-subscription) — upgrade, downgrade, or cancel your plan.
+- [Control your costs](/iroh-services/billing/control-costs) — set spend caps and monitor usage.
+- [Billing FAQ](/iroh-services/billing/faq) — common questions about billing and payments.
diff --git a/iroh-services/billing/manage-subscription.mdx b/iroh-services/billing/manage-subscription.mdx
new file mode 100644
index 0000000..0df8b8f
--- /dev/null
+++ b/iroh-services/billing/manage-subscription.mdx
@@ -0,0 +1,58 @@
+---
+title: "Manage Your Subscription"
+description: "Upgrade, downgrade, or cancel your Iroh Services subscription"
+---
+
+Manage your subscription from the [Iroh Services dashboard](https://n0des.iroh.computer).
+
+## Upgrade your plan
+
+1. Go to your project dashboard.
+2. Navigate to **Settings** > **Billing**.
+3. Select the plan you'd like to upgrade to.
+4. Confirm the change.
+
+Upgrades take effect immediately.
+
+## Remove relays
+
+Relays are charged to your account per hour of usage. To avoid unnecessary
+costs, make sure to remove any custom relays that you no longer need.
+
+1. Go to your project dashboard.
+2. Navigate to **Relays**.
+3. Click the three dot menu next to any custom relay to remove it.
+
+
+## Downgrade your plan
+
+In order to downgrade from Pro to Free, you need to remove any custom relays first.
+
+1. Go to your project dashboard.
+2. Navigate to **Settings** > **Billing**.
+3. Select a lower-tier plan.
+4. Confirm the change.
+
+
+## Cancel your subscription
+
+After cancellation, your data will be retained according to the Free plan's
+retention policy. There is no immediate deletion of data upon cancellation, but
+you will lose access to any features that are not included in the Free plan. If
+you decide to re-subscribe in the future, your data may still be accessible, but
+we cannot guarantee its availability because data cleanup may have occurred.
+
+1. Go to your project dashboard.
+2. Navigate to **Settings** > **Billing**.
+3. Click **Cancel subscription**.
+
+
+## Update payment method
+
+1. Go to your project dashboard.
+2. Navigate to **Settings** > **Billing**.
+3. Click **Payment method** to add or update your card on file.
+
+## Invoices
+
+Invoices are generated monthly and available in the **Billing** section of your dashboard. You can download past invoices at any time.
From cdc0f088bb1ae0d36306588b22aa7a779aaf77d6 Mon Sep 17 00:00:00 2001
From: Rae McKelvey <633012+okdistribute@users.noreply.github.com>
Date: Mon, 2 Mar 2026 11:13:01 -0800
Subject: [PATCH 2/3] add faq for billing
---
iroh-services/billing/faq.mdx | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/iroh-services/billing/faq.mdx b/iroh-services/billing/faq.mdx
index 0b4d84a..2ffabaf 100644
--- a/iroh-services/billing/faq.mdx
+++ b/iroh-services/billing/faq.mdx
@@ -41,6 +41,11 @@ details.
Invoices are available in the **Settings** > **Billing** section of your
[project dashboard](https://n0des.iroh.computer).
+## Are taxes included in the prices?
+
+Prices shown do not include taxes. Applicable taxes (such as VAT or sales tax)
+may or may not be added at checkout based on your billing address and your local tax rules.
+
## I have a billing question not listed here
Reach out to us at [support@iroh.computer](mailto:support@iroh.computer).
From 845f9b919b1c56eb6d647d6def36c0d6c57b44b0 Mon Sep 17 00:00:00 2001
From: rae <633012+okdistribute@users.noreply.github.com>
Date: Mon, 2 Mar 2026 11:15:31 -0800
Subject: [PATCH 3/3] Update control-costs.mdx
---
iroh-services/billing/control-costs.mdx | 16 ++++------------
1 file changed, 4 insertions(+), 12 deletions(-)
diff --git a/iroh-services/billing/control-costs.mdx b/iroh-services/billing/control-costs.mdx
index 5aff173..a34f596 100644
--- a/iroh-services/billing/control-costs.mdx
+++ b/iroh-services/billing/control-costs.mdx
@@ -12,12 +12,12 @@ Spend caps let you set a maximum monthly budget for your project. When your usag
### Setting a spend cap
1. Go to your project dashboard.
-2. Navigate to **Settings** > **Billing**.
+2. Navigate to **Settings**
3. Under **Spend cap**, enter your maximum monthly budget.
4. Click **Save**.
-Your spend cap does not include your base plan cost. It only applies to usage-based charges that exceed what's included in your plan.
+Your spend cap applies to your total invoice, including the base plan cost, any applicable taxes, and usage-based charges that exceed what's included in your plan.
### What happens when you hit your cap
@@ -26,16 +26,8 @@ When your usage-based charges reach your spend cap:
- **Metrics ingestion** will be paused. Endpoints will stop sending new metrics until the next billing cycle.
- **Your existing data** is preserved. Dashboards and historical metrics remain accessible.
-- **Relay connections** are not affected. Your endpoints will continue to connect through relays.
-
-You can raise or remove your spend cap at any time from the billing settings.
-
-## Monitor usage
-
-Track your current usage from the project dashboard:
-
-- **Metrics volume** — the number of metric events ingested this billing cycle.
-- **Endpoint connections** — the number of active connections sending metrics to your project.
+- **Endpoint connections** — the number of active connections sending metrics to your project will be throttled.
+- **Active relay connections** are not affected. Your endpoints will continue to connect through relays.
Usage resets at the start of each billing cycle.