MorpheusUI configuration lives in MorpheusUI/.env (or the equivalent platform-specific resource). The complete annotated dump is at docs/ui-desktop.all.env. Source of truth: MorpheusUI/src/main/config/index.ts.

Auth & networking

VariableDefaultNotes
BYPASS_AUTHfalsetrue to bypass auth (dev only)
PROXY_WEB_DEFAULT_PORT8082Default port for the local proxy-router
PROXY_WEB_URLhttp://localhost:8082Override the local API URL

Chain

VariableDefaultNotes
CHAIN_ID(unset)8453 (mainnet) or 84532 (testnet)
DEFAULT_SELLER_CURRENCYBTCDefault seller currency symbol
DIAMOND_ADDRESSmainnet 0x6aBE1d282f72B474E54527D93b979A4f64d3030a; testnet 0x6e4d0B775E3C3b02683A6F277Ac80240C4aFF930Diamond contract
EXPLORER_URL(unset)Block explorer URL

Branding

VariableDefaultNotes
DISPLAY_NAMEMorpheusUIWindow/title text

Pairing with a custom proxy-router

Most consumer setups use the bundled proxy-router that mor-launch starts. To point the UI at a separate proxy-router (e.g. a Docker container or a remote C-Node):
  1. Stop the bundled proxy-router (or don’t run mor-launch).
  2. Start your own proxy-router and confirm http://<host>:8082/healthcheck.
  3. Set PROXY_WEB_URL=http://<host>:8082 in MorpheusUI’s .env.
  4. Restart MorpheusUI.

Full annotated dump

For every variable (including theme tweaks, debug flags, and feature toggles), see docs/ui-desktop.all.env.