initial docs setup

1 files changed, 94 insertions, 0 deletions

diff --git a/apps/docs/self-hosting.mdx b/apps/docs/self-hosting.mdx
new file mode 100644
index 00000000..efac8170
--- /dev/null
+++ b/apps/docs/self-hosting.mdx
@@ -0,0 +1,94 @@
+---
+title: "Self-hosting"
+description: "Self-host Supermemory on your own infrastructure"
+---
+
+## Local Setup
+
+<AccordionGroup>
+  <Accordion icon="github" title="Clone the repository">
+    ```bash
+    git clone https://github.com/supermemoryai/supermemory.git
+    cd supermemory
+    npm i -g bun
+    bun install
+    ```
+  </Accordion>
+
+  <Accordion icon="database" title="Database Setup">
+    To spin up the database locally, use Docker Compose:
+
+    ```bash
+    docker-compose up -d
+    ```
+
+    This will start a PostgreSQL database with pgvector extension at `localhost:5432`.
+
+    To generate and apply migrations:
+    ```bash
+    bun run generate-migration
+    bun run migrate:local
+    ```
+
+    > Note: When coding or making changes, you MUST use the drizzle-orm functions exported from `packages/db` for interacting with the database. Not using them will cause type errors that are hard to debug.
+  </Accordion>
+
+  <Accordion icon="gear" title="Environment Variables">
+    #### Backend (`apps/backend/.env` and `apps/backend/.dev.vars`):
+
+    ```env
+    WORKOS_API_KEY=your_workos_api_key
+    WORKOS_CLIENT_ID=your_workos_client_id
+    WORKOS_COOKIE_PASSWORD=your_cookie_password
+    DATABASE_URL="postgresql://postgres:postgres@localhost:5432/supermemorylocal"
+    CONTENT_WORKFLOW=your_content_workflow
+    GEMINI_API_KEY=your_gemini_api_key
+    NODE_ENV=development
+    OPEN_AI_API_KEY=your_openai_api_key
+    BRAINTRUST_API_KEY=your_braintrust_api_key
+    RESEND_API_KEY=your_resend_api_key
+    TURNSTILE_SECRET_KEY=your_turnstile_secret_key
+    ```
+
+    #### Web (`apps/web/.env` and `apps/web/.dev.vars`):
+
+    ```env
+    WORKOS_CLIENT_ID=your_workos_client_id
+    WORKOS_API_KEY=your_workos_api_key
+    WORKOS_REDIRECT_URI="http://localhost:3000/callback"
+    WORKOS_COOKIE_PASSWORD=your_cookie_password
+    DATABASE_URL="postgresql://postgres:postgres@localhost:5432/supermemorylocal"
+
+    CLOUDFLARE_ACCOUNT_ID=your_cloudflare_account_id
+    R2_ACCESS_KEY_ID=your_r2_access_key_id
+    R2_SECRET_ACCESS_KEY=your_r2_secret_access_key
+
+    BACKEND_URL=http://localhost:8787
+    OPENAI_API_KEY=your_openai_api_key
+    NOTION_CLIENT_ID=your_notion_client_id
+    NOTION_CLIENT_SECRET=your_notion_client_secret
+
+    NODE_ENV=development
+    STRIPE_CHECKOUT_KEY=your_stripe_checkout_key
+    STRIPE_WEBHOOK_SECRET=your_stripe_webhook_secret
+    ```
+
+    You also need to update the Wrangler config for the web app and backend to your own account's resources on Cloudflare.
+  </Accordion>
+
+  <Accordion icon="code" title="Schema Changes">
+    To edit the database schema, modify the files in `packages/db/schema.ts`, and then repeat the migration steps from the Database Setup section.
+  </Accordion>
+
+  <Accordion icon="rocket" title="Running the Application">
+    1. Install dependencies:
+    ```bash
+    bun install
+    ```
+
+    2. Start the development servers:
+    ```bash
+    bun run dev
+    ```
+  </Accordion>
+</AccordionGroup>