Deployment options

Two supported paths: the CLI provisioner, or clone the monorepo and run IaC directly. Both use the same stack and optional deploy config.

CLI provision

machine-memory remote provision

That command:

1. Loads optional machine-memory.deploy.json (see deploy config)
2. Runs alchemy deploy for the multi-worker stack
3. Generates or reuses a Worker token for the REST API
4. Stores the router URL + token in the OS keychain (for CLI --remote)

Command details: remote provision.

Self-host (no docs site)

Most operators only need API + MCP. Skip the docs worker and set your own domain/names via a config file:

cp iac/machine-memory.deploy.example.json ./machine-memory.deploy.json
# edit domain, worker names, set "docs": false
machine-memory remote provision --config ./machine-memory.deploy.json

Or one-shot flags:

machine-memory remote provision --no-docs --domain memory.example.com

With no domain, the router is reachable at https://<router-name>.<account>.workers.dev.

Clone the repo and run IaC

git clone https://github.com/jfalava/machine-memory.git
cd machine-memory/iac
# optional: machine-memory.deploy.json in this directory or MACHINE_MEMORY_* env
CI=1 bun run deploy
# first time against an existing account resource set:
# CI=1 bunx alchemy deploy --yes --adopt

MCP OAuth secrets are optional at this stage. Without them the API still serves REST; MCP routes return 503 until you enable the endpoint.

After a direct IaC deploy, point the CLI at the router base URL with remote setup.

Deploy config file

Copy machine-memory.deploy.example.json:

{
  "domain": "memory.example.com",
  "docs": false,
  "stackName": "machine-memory-remote-db",
  "database": "machine-memory-db",
  "vectorIndex": "machine-memory-v1",
  "oauthKv": "machine-memory-oauth-kv",
  "workers": {
    "router": "machine-memory-router",
    "api": "machine-memory-api",
    "mcp": "machine-memory-mcp",
    "docs": "machine-memory-docs"
  }
}

Precedence: CLI flags → config file → MACHINE_MEMORY_* env → saved remote credentials → defaults.