treeverse · talSofer · Jun 25, 2024 · Jun 25, 2024 · Jun 25, 2024 · Jun 25, 2024
diff --git a/docs/enterprise/architecture.md b/docs/enterprise/architecture.md
diff --git a/docs/enterprise/fluffy-configuration.md → docs/enterprise/configuration.md b/docs/enterprise/fluffy-configuration.md → docs/enterprise/configuration.md
@@ -1,9 +1,14 @@
 ---
-title: Fluffy Server Configuration
-description: Configuration reference for Fluffy Server
+title: lakeFS Enterprise Configuration reference
+description: a configuration reference for lakeFS Enterprise
+nav_order: 110
 parent: lakeFS Enterprise
 ---
 
+TODO: add an intro
+
+# lakeFS Configuration
+
 # Fluffy Server Configuration
 
 {% include toc.html %}

diff --git a/docs/enterprise/getstarted/index.md b/docs/enterprise/getstarted/index.md
@@ -0,0 +1,7 @@
+---
+title: Get Started with lakeFS Enterprise
+description: Methods for getting started with lakeFS Enterprise
+has_children: true
+nav_order: 100
+parent: lakeFS Enterprise
+---
diff --git a/docs/enterprise/getstarted/install.md b/docs/enterprise/getstarted/install.md
@@ -0,0 +1,6 @@
+---
+title: Install lakeFS Enterprise
+description: lakeFS Enterprise Installation Guide
+nav_order: 105
+parent: Get Started with lakeFS Enterprise
+---
diff --git a/docs/enterprise/getstarted/migrate-from-oss.md b/docs/enterprise/getstarted/migrate-from-oss.md
@@ -0,0 +1,6 @@
+---
+title: Migrate from lakeFS OSS
+description: How to migrate from lakeFS OSS to lakeFS Enterprise
+nav_order: 110
+parent: Get Started with lakeFS Enterprise
+---
diff --git a/docs/enterprise/getstarted/quickstart.md b/docs/enterprise/getstarted/quickstart.md
@@ -0,0 +1,6 @@
+---
+title: lakeFS Enterprise Quickstart
+description: Quickstart guides for lakeFS Enterprise
+nav_order: 100
+parent: Get Started with lakeFS Enterprise
+---
diff --git a/docs/enterprise/index.md b/docs/enterprise/index.md
@@ -3,7 +3,6 @@ title: lakeFS Enterprise
 description: lakeFS Enterprise is an enterprise-ready lakeFS solution providing additional features including RBAC, SSO and Support SLA.
 has_children: true
 nav_order: 110
-has_toc: false
 ---
 
 # lakeFS Enterprise
@@ -36,3 +35,42 @@ release info found in [Github releases](https://github.com/treeverse/lakeFS/rele
 You can learn nore about [lakeFS Enterprise architecture]({% link enterprise/architecture.md %}), or 
 follow the examples in the [quickstart guide]({% link enterprise/orchestration.md %}).
 
+## Architecture
+
+---
+title: Enterprise Architecture
+description: Understand  lakeFS Enterprise Architecture
+parent: lakeFS Enterprise
+---
+
+# Architecture
+
+![img.png](../assets/img/enterprise/enterprise-arch.png)
+
+[1] Any user request to lakeFS via Browser or Programmatic access (SDK, HTTP
+API, lakectl).
+
+[2] Reverse Proxy (e.g. NGINX, Traefik, K8S Ingress): will handle user requests
+and proxy between lakeFS server and fluffy server based on the path prefix
+while maintaining the same host.
+
+[3] lakeFS server - the main lakeFS service.
+
+[4] fluffy server - service that is responsible for the Enterprise features.,
+it is separated by ports for security reasons.
+
+1. SSO auth (i.e Browser login via Azure AD, Okta, Auth0), default port 8000.
+1. RBAC authorization, default port 9000.
+
+[5] The [KV Store]({% link understand/architecture.md %}) - Where metadata is stored used both by lakeFS and fluffy.
+
+[6] SSO IdP - Identity provider (e.g. Azure AD, Okta, JumpCloud). fluffy
+implements SAML and Oauth2 protocols.
+
+
+For more details and pricing, please [contact sales](https://lakefs.io/contact-sales/).
+
+
+**Note:** Setting up lakeFS enterprise with an SSO IdP (OIDC, SAML or LDAP) requires
+configuring access from the IdP too.
+{: .note }
diff --git a/docs/enterprise/upgrade.md b/docs/enterprise/upgrade.md
@@ -0,0 +1,6 @@
+---
+title: Upgrade lakeFS Enterprise
+description: How to upgrade lakeFS Enterprise
+nav_order: 105
+parent: lakeFS Enterprise
+---