Skip to content

An AI-powered search engine with a generative UI

docs: add Database section to CONFIGURATION.md

Yoshiki Miuraa7d10352ae61
diff --git a/docs/CONFIGURATION.md b/docs/CONFIGURATION.md
index e07165ad..f5523764 100644
--- a/docs/CONFIGURATION.md
+++ b/docs/CONFIGURATION.md
@@ -4,12 +4,37 @@ This guide covers the optional features and their configuration in Morphic.
## Table of Contents
+- [Database](#database)
- [Authentication](#authentication)
- [Guest Mode](#guest-mode)
- [Search Providers](#search-providers)
- [Additional AI Providers](#additional-ai-providers)
- [Other Features](#other-features)
+## Database
+
+Morphic uses PostgreSQL for chat history storage. A database is **optional** for basic usage — without it, Morphic runs in a stateless mode where chat history is not persisted.
+
+### Setting Up PostgreSQL
+
+Set the connection string in `.env.local`:
+
+```bash
+DATABASE_URL=postgresql://user:password@localhost:5432/morphic
+```
+
+Any PostgreSQL provider works: [Neon](https://neon.tech/), [Supabase](https://supabase.com/), or a local PostgreSQL instance.
+
+### Running Migrations
+
+After configuring your database, run migrations to create the necessary tables:
+
+```bash
+bun run migrate
+```
+
+This command applies all migrations from the `drizzle/` directory.
+
## Authentication
By default, Morphic runs in **anonymous mode** with authentication disabled (`ENABLE_AUTH=false` in `.env.local.example`). This is ideal for personal use where all users share a single anonymous user ID.