diff --git a/fern/products/docs/docs.yml b/fern/products/docs/docs.yml
index 835af3ef3..8ad97ef4e 100644
--- a/fern/products/docs/docs.yml
+++ b/fern/products/docs/docs.yml
@@ -180,10 +180,10 @@ navigation:
path: ./pages/api-references/autopopulate-api-key.mdx
- page: SSO
path: ./pages/authentication/sso.mdx
- - section: Enterprise
- collapsed: true
- contents:
- - page: Self-hosted
+ - section: Self-Hosted
+ collapsed: true
+ contents:
+ - page: Overview
path: ./pages/enterprise/self-hosted.mdx
- section: Integrations
collapsed: true
diff --git a/fern/products/docs/pages/enterprise/self-hosted.mdx b/fern/products/docs/pages/enterprise/self-hosted.mdx
index 0fabf4df1..f5d2e7b9f 100644
--- a/fern/products/docs/pages/enterprise/self-hosted.mdx
+++ b/fern/products/docs/pages/enterprise/self-hosted.mdx
@@ -1,7 +1,60 @@
---
-title: Self-hosted Enterprise
+title: Self-Hosted Documentation
+description: Fern supports self-hosting so that you can run your docs site on your own infrastructure.
---
-Fern supports self-hosting so that you can run your docs site on your own infrastructure.
+Self-hosted documentation is only available for the enterprise plan.
+
+Fern documentation websites are hosted on Fern's infrastructure by default. Self-hosting allows you to deploy your documentation site on your own infrastructure to meet specific security or compliance requirements.
+
+## When to Use Self-Hosting
+
+Self-hosting is typically required for organizations that operate without internet access, have strict compliance requirements, or need full control over their documentation servers.
+
+When you self-host, you're responsible for server setup, security, maintenance, and deciding how to make the documentation accessible to your users.
+
+
+Unless you have specific requirements that prevent using Fern's default hosting, we recommend **using our managed hosting solution** for easier setup and maintenance.
+
+
+### Feature Support
+
+Self-hosted deployments include core Fern documentation website features like auto-generated API references, interactive documentation, SDK code snippets, search, and customizable branding.
+
+However, features requiring external connections aren't supported, including [Ask Fern](/ask-fern/getting-started/what-is-ask-fern) (AI chat), [analytics](/integrations/overview), [live API key population](/docs/authentication/api-key-injection), and [SSO integrations](/docs/authentication/sso).
+
+
+**PDF export** and **offline AI chat functionality** are in development for self-hosted deployments. [Email us](mailto:support@buildwithfern.com) if you're interested in these features.
+
+
+## Setup Process
+
+Fern provides your documentation site as a ready-to-run Docker container that you can deploy on your own infrastructure.
+
+1. **Download the Docker image** - Fern provides the location of the most up-to-date Docker image containing the documentation frontend
+1. **Upload your fern folder** - Add your documentation source files to the container
+1. **Run the container** - Spin up your local server using standard Docker commands
+1. **Configure hosting** - Set up your server environment and decide how to publish/share the documentation
+1. **Receive updated Docker images** - Fern releases new versions of the Docker image that your team can evaluate and deploy when ready.
+
+### Architecture Diagram
+
+```mermaid
+sequenceDiagram
+ participant F as Fern
+ participant C as Customer
+ participant S as Customer Server
+
+ F->>C: Provides Docker image
+ C->>S: Upload fern folder
+ C->>S: Run Docker command
+ S->>S: Host documentation locally
+ F->>C: Releases updated Docker image
+ C->>C: Evaluate new version
+ C->>S: Deploy updated image
+```
+
+
+
+
-Docs are coming soon for this page.
Please [book a demo](https://buildwithfern.com/book-demo) or [reach out to us](https://buildwithfern.com/book-demo) to get set up with this feature.