dockette/memzero repository overview

⁠Dockette / Memzero

🐳 Mem0⁠ self-hosted memory layer (API + dashboard + pgvector) in a single stack.

🕹 f3l1x.io⁠ | 💻 f3l1x⁠ | 🐦 @xf3l1x⁠

⁠Images

Mem0 ships a self-hosted server, but no maintained prebuilt images. This repository builds multiarch (amd64, arm64) images from upstream mem0 releases.

Use the versioned tags (e.g. server-2.2.1) in production. The unversioned tags move with every rebuild.

⁠Usage

1. Download docker-compose.yml⁠, postgres/init-db.sh⁠ and .env.dist⁠.

2. Copy .env.dist to .env, then set OPENAI_API_KEY and change JWT_SECRET and POSTGRES_PASSWORD.

3. Start the stack.

docker compose up

1. Open http://localhost:3000 and finish the setup wizard. It creates the first admin account and API key.

2. Use the API (OpenAPI docs on http://localhost:8888/docs).

curl -X POST http://localhost:8888/memories \
	-H "X-API-Key: your-api-key" \
	-H "Content-Type: application/json" \
	-d '{"messages":[{"role":"user","content":"I love hiking"}],"user_id":"alice"}'

Data is persisted in .docker/postgres and .docker/history.

⁠Configuration

All variables are listed in .env.dist⁠. The most important ones:

See the Mem0 documentation⁠ for more.

⁠Build

make build      # build both images
make test       # smoke test both images
make push       # push both images
make up         # start the stack
make health     # check the stack
make clean      # stop the stack and drop data

To upgrade mem0, bump MEM0_VERSION in .env.dist, Dockerfile and dashboard/Dockerfile. CI fails if they differ.

⁠Development

See how to contribute⁠ to this package.

This package is currently maintaining by these authors.

⁠

Consider to support⁠ f3l1x. Also thank you for using this package.