From 3903db90c91c4a41469403c5371501c0cb9dddfa Mon Sep 17 00:00:00 2001
From: Dawson Toth <dawson@harperdb.io>
Date: Fri, 27 Mar 2026 13:14:38 -0400
Subject: [PATCH] feat: BYOD

---
 fabric/custom-domains.md | 59 ++++++++++++++++++++++++++++++++++++++++
 sidebarsFabric.ts        |  5 ++++
 2 files changed, 64 insertions(+)
 create mode 100644 fabric/custom-domains.md

diff --git a/fabric/custom-domains.md b/fabric/custom-domains.md
new file mode 100644
index 00000000..aab7466d
--- /dev/null
+++ b/fabric/custom-domains.md
@@ -0,0 +1,59 @@
+---
+title: Custom Domains (BYOD)
+---
+
+# Custom Domains (Bring Your Own Domain)
+
+You can configure your own custom domains for Fabric Clusters to provide a branded experience for your users.
+
+## Accessing Domain Configuration
+
+Domain configuration is accessible through two primary paths:
+
+1.  **From the Fabric Dashboard:**
+    - Log in to [https://fabric.harper.fast/](https://fabric.harper.fast/).
+    - Click on your organization name.
+    - Locate the cluster you want to configure and click the context menu (three dots "**...**").
+    - Select the **Domains** configuration option.
+2.  **From Cluster Configuration:**
+    - Connect to your cluster.
+    - Navigate to **Config** and then **Domains**.
+
+## Configuration Steps
+
+Follow these steps to set up your custom domain:
+
+### 1. Add Domain
+
+Type in your domain name and click **Add**.
+
+### 2. Verify Ownership
+
+To confirm you own the domain, you must add the TXT records displayed on the screen to your domain registrar.
+
+- Once added, click the **Validate** button.
+- **Note:** It may take 10 minutes or more for DNS changes to propagate across your domain registrar.
+
+### 3. Configure CNAME
+
+After ownership is verified, you will be instructed to add a CNAME record to your domain registrar pointing to the Harper Fabric load balancer.
+
+:::info Apex Domains
+Some registrars do not support CNAME records for apex domains (e.g., `yourdomain.com`). In this case, we recommend:
+
+1.  Registering a subdomain like `www.yourdomain.com`.
+2.  Redirecting the apex domain (`@` or `yourdomain.com`) to the `www` subdomain.
+    :::
+
+### 4. Bind Domain
+
+Once the CNAME is set up, you can bind the domain to your cluster.
+
+### 5. SSL Certificate Generation
+
+After binding, SSL certificates will be automatically generated for your domain.
+
+- This process typically takes **5-10 minutes**.
+- Please be patient; the interface will show you the progress as it goes.
+
+Everything should be working once the SSL certificate is successfully generated!
diff --git a/sidebarsFabric.ts b/sidebarsFabric.ts
index a64d356b..529e8778 100644
--- a/sidebarsFabric.ts
+++ b/sidebarsFabric.ts
@@ -27,6 +27,11 @@ const sidebarsFabric: SidebarsConfig = {
 			id: 'cluster-creation-management',
 			label: 'Cluster Creation & Management',
 		},
+		{
+			type: 'doc',
+			id: 'custom-domains',
+			label: 'Custom Domains',
+		},
 		{
 			type: 'doc',
 			id: 'managing-applications',