Memora Standalone - Quick Start

What is this?

A single Docker image containing everything you need to run Memora:

✅ PostgreSQL database
✅ Dataplane API (FastAPI backend)
✅ Control Plane (Next.js web UI)

Fastest Start (Docker Compose)

cd standalone
docker-compose up -d

Access the UI at: http://localhost:3000

Manual Docker Build & Run

Build the image:

./standalone/build-docker.sh

Run with the helper script:

./standalone/run-docker.sh --persist

Or run directly:

docker run -d \
  --name memora \
  -p 3000:3000 \
  -p 8080:8080 \
  -p 5432:5432 \
  -v memora-data:/var/lib/postgresql/data \
  memora-standalone:latest

Access Points

Service	URL	Purpose
Control Plane	http://localhost:3000	Web UI
Dataplane API	http://localhost:8080	REST API
PostgreSQL	localhost:5432	Database

View Logs

docker logs -f memora-standalone

Stop & Remove

# Stop
docker-compose down

# Stop and remove data
docker-compose down -v

Environment Variables

Set in docker-compose.yml or pass with -e:

MEMORA_API_LLM_PROVIDER - LLM provider (openai, groq, ollama, none) (default: none)
MEMORA_API_LLM_API_KEY - API key for LLM provider
MEMORA_API_LLM_MODEL - LLM model name (default: openai/gpt-oss-120b)
MEMORA_API_LLM_BASE_URL - Optional custom LLM endpoint
MEMORA_CP_DATAPLANE_API_URL - Dataplane API URL (default: http://localhost:8080)

Troubleshooting

Container won't start:

docker logs memora-standalone

Database issues:

docker exec -it memora-standalone su - postgres -c "psql memora"

Reset everything:

docker-compose down -v
docker-compose up -d

Production Notes

This standalone image is ideal for:

✅ Development
✅ Demos
✅ Testing
✅ Small deployments

For production, consider:

Separate containers for each service
External PostgreSQL database
Kubernetes/Docker Swarm orchestration
Environment-specific configurations

2.1 KiB Raw Blame History