Get Started
Self-hosting
Get Started
Self-hosting
Self-host Supermemory on your own infrastructure
Local Setup
git clone https://github.com/supermemoryai/supermemory.git
cd supermemory
npm i -g bun
bun install
To spin up the database locally, use Docker Compose:
docker-compose up -d
This will start a PostgreSQL database with pgvector extension at localhost:5432.
To generate and apply migrations:
bun run generate-migration
bun run migrate:local
Note: When coding or making changes, you MUST use the drizzle-orm functions exported from
packages/dbfor interacting with the database. Not using them will cause type errors that are hard to debug.
Backend (apps/backend/.env and apps/backend/.dev.vars):
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):
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.
To edit the database schema, modify the files in packages/db/schema.ts, and then repeat the migration steps from the Database Setup section.
- Install dependencies:
bun install
- Start the development servers:
bun run dev
Was this page helpful?
On this page