Memora Standalone Docker Image

This directory contains the configuration to build a standalone Docker image that includes all Memora components in a single container:

PostgreSQL: Database backend
Dataplane: FastAPI backend service
Control Plane: Next.js web interface

Quick Start with Docker Compose

The easiest way to run the standalone image:

cd standalone
docker-compose up -d

This will build and start all services with persistent data storage.

To stop:

docker-compose down

To remove data and start fresh:

docker-compose down -v

Building Manually

./standalone/build-docker.sh

With custom options:

./standalone/build-docker.sh --name my-memora --tag v1.0.0
./standalone/build-docker.sh --registry docker.io/myuser --tag latest

Running Manually

Using the run script (recommended):

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

With custom ports:

./standalone/run-docker.sh --persist --port-control 3001 --port-api 8081

Direct docker run:

docker run -p 3000:3000 -p 8080:8080 memora-standalone:latest

With persistent data:

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

With custom environment variables:

docker run -p 3000:3000 -p 8080:8080 \
  -e MEMORA_API_LLM_PROVIDER=groq \
  -e MEMORA_API_LLM_API_KEY=your-key \
  -e MEMORA_API_LLM_MODEL=openai/gpt-oss-120b \
  memora-standalone:latest

Accessing Services

Once running, services are available at:

Control Plane: http://localhost:3000
Dataplane API: http://localhost:8080
PostgreSQL: localhost:5432 (username: postgres, password: postgres, database: memora)

Architecture

The container uses supervisord to manage three processes:

PostgreSQL (started first)
Dataplane API (started after PostgreSQL)
Control Plane (started after dataplane)

The init.sh script handles:

PostgreSQL initialization
Database creation
Running migrations
Starting all services via supervisord

Environment Variables

Variable	Default	Description
`MEMORA_API_DATABASE_URL`	`postgresql://postgres:postgres@localhost:5432/memora`	PostgreSQL connection string
`MEMORA_CP_DATAPLANE_API_URL`	`http://localhost:8080`	Dataplane API URL for control plane
`MEMORA_API_LLM_PROVIDER`	`none`	LLM provider (openai, groq, ollama, none)
`MEMORA_API_LLM_API_KEY`	-	API key for LLM provider
`MEMORA_API_LLM_MODEL`	`openai/gpt-oss-120b`	LLM model name
`MEMORA_API_LLM_BASE_URL`	-	Optional custom LLM endpoint

Logs

View logs from all services:

docker logs -f <container-id>

Production Considerations

This standalone image is designed for:

Development environments
Demos and testing
Small deployments

For production use, consider:

Using separate containers for each service
External PostgreSQL database
Load balancing for the control plane
Persistent volume for PostgreSQL data
Environment-specific configurations

3.1 KiB Raw Blame History