The proxy-router itself is published as a Docker image at ghcr.io/morpheusais/morpheus-lumerin-node. As a consumer you typically run it locally next to MorpheusUI or call its HTTP API directly. The container exposes the same :8082 admin/API and :3333 proxy ports.

​
Quickstart

For provider-side Docker (with model registration, public :3333, etc.), see Provider Docker. The two flows share the same image and 90% of the configuration.
1

Prepare a data dir and .env

Create a host directory you will mount into the container:
mkdir -p ~/morpheus-data
cd ~/morpheus-data
cat > proxy-router.env <<'EOF'
AUTH_CONFIG_FILE_PATH=/app/data/proxy.conf
COOKIE_FILE_PATH=/app/data/.cookie
RATING_CONFIG_PATH=/app/data/rating-config.json
PROXY_STORAGE_PATH=/app/data/data
MODELS_CONFIG_PATH=/app/data/models-config.json
ETH_NODE_CHAIN_ID=8453
BLOCKSCOUT_API_URL=https://base.blockscout.com/api/v2
DIAMOND_CONTRACT_ADDRESS=0x6aBE1d282f72B474E54527D93b979A4f64d3030a
MOR_TOKEN_ADDRESS=0x7431aDa8a591C955a994a21710752EF9b882b8e3
WALLET_PRIVATE_KEY=<your_consumer_wallet_private_key>
# Strongly recommended even for consumers — public round-robin fallback
# is rate-limited and unreliable; sessions can fail silently.
ETH_NODE_ADDRESS=https://base-mainnet.g.alchemy.com/v2/<your_alchemy_key>
ETH_NODE_USE_SUBSCRIPTIONS=false
PROXY_ADDRESS=0.0.0.0:3333
WEB_ADDRESS=0.0.0.0:8082
WEB_PUBLIC_URL=http://localhost:8082
EOF
2

Run the container

docker run -d \
  --name morpheus-proxy-consumer \
  --env-file proxy-router.env \
  -v ~/morpheus-data:/app/data \
  -p 8082:8082 \
  ghcr.io/morpheusais/morpheus-lumerin-node:latest
The TCP :3333 port is not required for consumers and can be omitted.
3

Validate

curl http://localhost:8082/healthcheck
Open Swagger at http://localhost:8082/swagger/index.html.

​
Networks

Switch to BASE Sepolia by replacing the four blockchain values in the .env. See Networks and tokens.

​
Pairing with MorpheusUI

If you also want the desktop UI, run the packaged release as in macOS / Windows / Linux, but stop the bundled proxy-router and point PROXY_WEB_URL (in MorpheusUI’s .env) at your container’s http://localhost:8082.

​
Direct API use

You can skip the UI entirely. See API direct for a curl-only walkthrough that opens a session and streams chat completions.