fleet-memory/standalone

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:

1. PostgreSQL (started first)
2. Dataplane API (started after PostgreSQL)
3. 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