⚡ 5-minute setup

Self-Host OpenClone

Run your personal memory system on any machine. Docker Compose, one command.

Requirements

  • ✓ Docker & Docker Compose (v2+)
  • ✓ 1 GB RAM minimum (2 GB recommended)
  • ✓ Any OS: Linux, macOS, Windows (WSL2)
  • ✓ API key from OpenAI, Anthropic, or OpenRouter (BYOK)

Quick Start

1
Clone the repository 
git clone https://github.com/[owner]/openclone
cd openclone
2
Configure environment 
cp backend/.env.example backend/.env
# Edit backend/.env:
#   API_KEY=your-secure-random-key
#   AI_API_KEY=your-openai-or-anthropic-key
3
Start the backend 
cd backend
docker compose up -d
4
Verify it's running 
curl http://localhost:8000/api/status
# → {"status": "ok", "version": "1.0.0"}

Configuration Reference

Variable Description Default
API_KEY Your secret key for API access (required)
AI_PROVIDER openai | anthropic | openrouter | gemini openai
AI_MODEL Model name (e.g. gpt-4o-mini) gpt-4o-mini
AI_API_KEY Your BYOK API key (required)
MEMORY_PATH Where to store your memory data /app/memory
GIT_AUTO_PUSH Auto-push memory to git repo false
DEFAULT_LANGUAGE Language for AI summaries en

Next steps