Docker Quickstart

This is the fastest way to get CortexDB running locally for development and early integration work.

Prerequisites

• Docker
• a terminal with curl available for quick verification

Quick Start

docker run -d \
  --name cortexdb \
  -p 3141:3141 \
  -v cortexdb-data:/data \
  cortexdb/cortexdb:latest

Verify the service

curl http://localhost:3141/v1/admin/health

Expected response:

{
  "status": "healthy",
  "storage": "ok"
}

Test a basic memory workflow

# Remember something
curl -X POST http://localhost:3141/v1/remember \
  -H "Content-Type: application/json" \
  -d '{"content":"CortexDB is running locally.","tenant_id":"quickstart"}'

# Recall it
curl -X POST http://localhost:3141/v1/recall \
  -H "Content-Type: application/json" \
  -d '{"query":"What is running locally?","tenant_id":"quickstart"}'

Docker Compose option

If you prefer a reusable local setup:

version: "3.8"

services:
  cortexdb:
    image: cortexdb/cortexdb:latest
    ports:
      - "3141:3141"
    volumes:
      - cortexdb-data:/data

volumes:
  cortexdb-data:

Start it with:

docker compose up -d

Next Steps