From f8558b6c6a79f70467b70127086ee7a515918102 Mon Sep 17 00:00:00 2001
From: Anish Sarkar <104695310+AnishSarkar22@users.noreply.github.com>
Date: Thu, 12 Mar 2026 21:11:39 +0530
Subject: [PATCH 1/2] feat: add new index sections for Connectors, Docker
Installation, and How-To Guides
---
.../content/docs/connectors/index.mdx | 101 ++++++++++++++++++
.../docs/docker-installation/index.mdx | 36 +++++++
surfsense_web/content/docs/how-to/index.mdx | 21 ++++
3 files changed, 158 insertions(+)
create mode 100644 surfsense_web/content/docs/connectors/index.mdx
create mode 100644 surfsense_web/content/docs/docker-installation/index.mdx
create mode 100644 surfsense_web/content/docs/how-to/index.mdx
diff --git a/surfsense_web/content/docs/connectors/index.mdx b/surfsense_web/content/docs/connectors/index.mdx
new file mode 100644
index 000000000..501b1fc0b
--- /dev/null
+++ b/surfsense_web/content/docs/connectors/index.mdx
@@ -0,0 +1,101 @@
+---
+title: Connectors
+description: Integrate with third-party services
+---
+
+import { Card, Cards } from 'fumadocs-ui/components/card';
+
+Connect SurfSense to your favorite tools and services. Browse the available integrations below to sync data from productivity apps, communication platforms, knowledge bases, and more.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/surfsense_web/content/docs/docker-installation/index.mdx b/surfsense_web/content/docs/docker-installation/index.mdx
new file mode 100644
index 000000000..929192164
--- /dev/null
+++ b/surfsense_web/content/docs/docker-installation/index.mdx
@@ -0,0 +1,36 @@
+---
+title: Docker Installation
+description: Deploy SurfSense using Docker
+---
+
+import { Card, Cards } from 'fumadocs-ui/components/card';
+
+Choose your preferred Docker deployment method below.
+
+
+
+
+
+
+
+
diff --git a/surfsense_web/content/docs/how-to/index.mdx b/surfsense_web/content/docs/how-to/index.mdx
new file mode 100644
index 000000000..de45db19c
--- /dev/null
+++ b/surfsense_web/content/docs/how-to/index.mdx
@@ -0,0 +1,21 @@
+---
+title: How-To Guides
+description: Step-by-step guides for common tasks
+---
+
+import { Card, Cards } from 'fumadocs-ui/components/card';
+
+Practical guides to help you get the most out of SurfSense.
+
+
+
+
+
From 0cf3acc3c1da57462d1cd90a0faf9ad531526b8a Mon Sep 17 00:00:00 2001
From: Anish Sarkar <104695310+AnishSarkar22@users.noreply.github.com>
Date: Thu, 12 Mar 2026 21:24:55 +0530
Subject: [PATCH 2/2] feat: update installation documentation with new
structure and content for manual installation
---
.../content/docs/connectors/meta.json | 2 +-
surfsense_web/content/docs/installation.mdx | 32 +++++++++++--------
.../content/docs/manual-installation.mdx | 2 +-
3 files changed, 21 insertions(+), 15 deletions(-)
diff --git a/surfsense_web/content/docs/connectors/meta.json b/surfsense_web/content/docs/connectors/meta.json
index 0c6dfe449..735331a2b 100644
--- a/surfsense_web/content/docs/connectors/meta.json
+++ b/surfsense_web/content/docs/connectors/meta.json
@@ -1,6 +1,6 @@
{
"title": "Connectors",
- "icon": "Cable",
+ "icon": "Unplug",
"pages": [
"google-drive",
"gmail",
diff --git a/surfsense_web/content/docs/installation.mdx b/surfsense_web/content/docs/installation.mdx
index aa3a2a72d..49f0b1ab3 100644
--- a/surfsense_web/content/docs/installation.mdx
+++ b/surfsense_web/content/docs/installation.mdx
@@ -1,21 +1,27 @@
---
title: Installation
-description: Current ways to use SurfSense
+description: How to install SurfSense - Docker or from source
icon: Download
---
-# Installing SurfSense
+import { Card, Cards } from 'fumadocs-ui/components/card';
+import { Container, Wrench } from 'lucide-react';
-There are two ways to install SurfSense, but both require the repository to be cloned first. Clone [SurfSense](https://github.com/MODSetter/SurfSense) and then:
+SurfSense runs as a Python backend + Next.js frontend. You can either spin it up with Docker or set everything up yourself.
-## Docker Installation
+**Not sure which to pick?** Docker gets you up and running fastest. Go manual if you want to build SurfSense with us or need full control over the stack.
-This method provides a containerized environment with all dependencies pre-configured. Less Customization.
-
-[Learn more about Docker installation](/docs/docker-installation/install-script)
-
-## Manual Installation (Preferred)
-
-For users who prefer more control over the installation process or need to customize their setup, we also provide manual installation instructions.
-
-[Learn more about Manual installation](/docs/manual-installation)
\ No newline at end of file
+
+ }
+ title="Docker Installation"
+ description="All dependencies pre-configured, up and running in minutes"
+ href="/docs/docker-installation"
+ />
+ }
+ title="Manual Installation"
+ description="Set up each component yourself for full control"
+ href="/docs/manual-installation"
+ />
+
diff --git a/surfsense_web/content/docs/manual-installation.mdx b/surfsense_web/content/docs/manual-installation.mdx
index 7a974150c..96f272717 100644
--- a/surfsense_web/content/docs/manual-installation.mdx
+++ b/surfsense_web/content/docs/manual-installation.mdx
@@ -1,6 +1,6 @@
---
title: Manual Installation
-description: Setting up SurfSense manually for customized deployments (Preferred)
+description: Setting up SurfSense manually for customized deployments
icon: Wrench
---