first candidate for launch

content/docs/enterprise/domains/_index.md

@@ -0,0 +1,10 @@
+---
+weight: 170
+title: "Domains"
+description: "Manage Federated and custom domains for your account."
+icon: "article"
+date: "2025-05-27T00:00:00-00:00"
+lastmod: "2025-05-27T00:00:00-00:00"
+draft: false
+toc: true
+---

content/docs/enterprise/domains/buying-a-custom-domain.md

@@ -0,0 +1,26 @@
+---
+weight: 172
+title: "Buying a Custom Domain"
+description: "How to search for and purchase a custom domain from the dashboard."
+icon: "article"
+date: "2025-05-27T00:00:00-00:00"
+lastmod: "2025-05-27T00:00:00-00:00"
+draft: false
+toc: true
+---
+
+You can add custom domains to your account either during checkout or at any time from the **Domains** section of the dashboard. Only **Owners** and **Admins** can purchase domains.
+
+## Checking Domain Availability
+
+Before purchasing, you can search for a domain name to check whether it's available and see the registration and renewal pricing. Enter the full domain name including the TLD (e.g., `mycompany.com`).
+
+## Purchasing a Domain
+
+1. Go to **Domains** in the dashboard and click **Add Domain**.
+2. Search for your desired domain name to confirm availability and pricing.
+3. Confirm the purchase. The displayed price is for a one-year registration.
+4. Payment is processed immediately. Your account balance is applied first; any remaining amount is charged to your card on file.
+5. The domain is registered with our registrar partner. Registration can take a few minutes to complete. You'll receive an invoice by email.
+
+> **Note:** Domain registration failures are rare but can occur if the domain becomes unavailable between your availability check and the registration attempt. If a registration fails, your payment is refunded automatically and you'll receive a notification email.

content/docs/enterprise/domains/domain-renewal.md

@@ -0,0 +1,28 @@
+---
+weight: 173
+title: "Domain Renewal"
+description: "How custom domain renewal works, including auto-renewal and failure handling."
+icon: "article"
+date: "2025-05-27T00:00:00-00:00"
+lastmod: "2025-05-27T00:00:00-00:00"
+draft: false
+toc: true
+---
+
+Custom domains are registered for one year at a time. Federated Enterprise automatically handles renewal so your domains stay active without manual intervention.
+
+## Auto-Renewal
+
+By default, all custom domains are set to **auto-renew**. Before a domain expires, the platform will charge the renewal fee to your account (balance first, then card) and renew the registration for another year.
+
+You can toggle auto-renewal on or off for individual domains from the Domains page. Only **Owners** and **Admins** can change this setting.
+
+> **Warning:** If you disable auto-renewal, you are responsible for renewing the domain before it expires. An expired domain may become available for registration by others and can disrupt your Cores and services.
+
+## Renewal Failures
+
+If a renewal charge fails (e.g., due to an expired card or insufficient balance), you'll receive a notification email. The platform will attempt the renewal again, but it's important to ensure your payment method is up to date to avoid service interruption.
+
+## Federated Domains
+
+Federated-managed domains (`federatedcomputer.cloud`, `federatedcomputer.net`, `fedcom.net`) are maintained by Federated Computer and never expire or require renewal from your side.

content/docs/enterprise/domains/federated-vs-custom-domains.md

@@ -0,0 +1,38 @@
+---
+weight: 171
+title: "Federated Domains vs Custom Domains"
+description: "Understand the two domain options available for your account."
+icon: "article"
+date: "2025-05-27T00:00:00-00:00"
+lastmod: "2025-05-27T00:00:00-00:00"
+draft: false
+toc: true
+---
+
+Every Federated Enterprise account requires at least three domains. These domains are used by your Cores and the platform to route traffic, send email, and serve your environment. You can choose between two types of domains.
+
+## Federated Domains
+
+Federated Computer provides a set of shared domains that you can use at no extra cost:
+
+- `federatedcomputer.cloud`
+- `federatedcomputer.net`
+- `fedcom.net`
+
+These domains are owned and managed by Federated Computer. Using them requires no registration fees and no renewal management on your end — they're always active for as long as your account is active. This is the fastest way to get started and is fully functional for most use cases.
+
+## Custom Domains
+
+If you want to run your environment under your own brand, you can register custom domains through the Federated Enterprise platform. Custom domains are purchased through our domain registrar partner and are registered to your account.
+
+Custom domains carry a registration fee (paid at checkout or when added post-signup) and an annual renewal fee. Domain pricing varies by TLD. You can check availability and current pricing in the checkout flow or on the Domains page in your dashboard.
+
+## Comparison
+
+| Feature | Federated Domains | Custom Domains |
+|---|---|---|
+| Registration cost | Free | Varies by TLD |
+| Annual renewal | Free | Varies by TLD |
+| Your own brand | No | Yes |
+| Available immediately | Yes | After registration |
+| Managed by Federated | Yes | No |

content/docs/enterprise/domains/why-3-domains-are-required.md

@@ -0,0 +1,18 @@
+---
+weight: 174
+title: "Why 3 Domains Are Required"
+description: "The technical reason your account needs a minimum of three domains."
+icon: "article"
+date: "2025-05-27T00:00:00-00:00"
+lastmod: "2025-05-27T00:00:00-00:00"
+draft: false
+toc: true
+---
+
+Federated Enterprise requires a minimum of **three domains** when you sign up, and this is a technical requirement of the platform — not an arbitrary constraint.
+
+The underlying Federated Core platform uses multiple domains in tandem to support the various services that run on your Cores. These services include unified messaging, unified storage, authentication, and other components of the Core environment. Each domain serves a distinct functional purpose in the platform's routing and service delivery architecture.
+
+Having three separate domains ensures that services can be isolated, routed independently, and remain resilient if one domain encounters an issue. It also allows the platform to properly configure email delivery, SSL certificates, and service endpoints across your environment.
+
+> **Note:** If you're unsure which domains to register, choosing the free Federated Domains option at checkout gets you a compliant, fully functional three-domain setup with no additional cost or configuration required.