Spin up Keep with docker-compose latest images

The easiest way to start keep is is with docker-compose:

curl -s | docker-compose -f - up

The docker-compose.yml contains two services:

  • keep-backend - a fastapi service that as the API server.
  • keep-frontend - a nextjs app that serves as Keep UI interface.

Docker-compose dev images

You can use to start Keep in a development mode.

First, clone the Keep repo:

git clone && cd keep

Next, run

docker-compose -f - up


Keep can be installed via Helm Chart.

First, clone Keep:

git clone && cd keep

Next, install using:

helm install -f chart/keep/values.yaml keep chart/keep/

Notice for it to work locally, you’ll need this port forwarding:

kubectl port-forward svc/keep-frontend 3000:3000

To learn more about Keep’s helm chart, see


You can run Keep from your VSCode (after cloning the repo) by adding this configurations to your launch.json:

    "version": "0.2.0",
    "configurations": [
        "name": "Keep Backend",
        "type": "python",
        "request": "launch",
        "program": "keep/cli/",
        "console": "integratedTerminal",
        "justMyCode": false,
        "args": ["--json", "api","--multi-tenant"],
        "env": {"PYDEVD_DISABLE_FILE_VALIDATION": "1"}
        "name": "Keep Frontend",
        "type": "node-terminal",
        "request": "launch",
        "command": "npm run dev",
        "cwd": "${workspaceFolder}/keep-ui",