# Env: MorpheusUI

Source: https://nodedocs.mor.org/reference/env-ui-desktop

## Agent Instructions

- Non-browser fetches of page URLs on this site return clean Markdown (not the JS UI). Prefer `https://nodedocs.mor.org/llms-full.txt` for the full corpus, or `https://nodedocs.mor.org/llms.txt` for the index.
- Per-page Markdown is also at `<page-url>.md` (homepage: `https://nodedocs.mor.org/index.md`).
- Docs search MCP: `https://nodedocs.mor.org/mcp` (discovery: `https://nodedocs.mor.org/.well-known/mcp`).
- Never invent contract addresses, chain IDs, token addresses, or live bid/model counts. Cite Networks and tokens; link active.mor.org for live data.
- Never claim Morpheus runs inference — independent providers do. Opening a session escrows MOR; it does not spend it.

MorpheusUI configuration lives in `ui-desktop/.env` when building from source (or the equivalent platform-specific resource for a packaged install). The complete annotated dump is at [`docs/ui-desktop.all.env`](https://github.com/MorpheusAIs/Morpheus-Lumerin-Node/blob/main/docs/ui-desktop.all.env). Source of truth: [`ui-desktop/src/main/config/index.ts`](https://github.com/MorpheusAIs/Morpheus-Lumerin-Node/blob/main/ui-desktop/src/main/config/index.ts).

## Auth & networking

| Variable | Default | Notes |
|----------|---------|-------|
| `BYPASS_AUTH` | `false` | `true` to bypass auth (dev only) |
| `PROXY_WEB_DEFAULT_PORT` | `8082` | Default port for the local proxy-router |
| `PROXY_WEB_URL` | `http://localhost:8082` | Override the local API URL |

## Chain

| Variable | Default | Notes |
|----------|---------|-------|
| `CHAIN_ID` | (unset) | `8453` (mainnet) or `84532` (testnet) |
| `DEFAULT_SELLER_CURRENCY` | `BTC` | Default seller currency symbol |
| `DIAMOND_ADDRESS` | mainnet `0x6aBE1d282f72B474E54527D93b979A4f64d3030a`; testnet `0xA328196f2438DADA5ab729E39388D86896c27c85` | Diamond contract |
| `EXPLORER_URL` | (unset) | Block explorer URL |

## Branding

| Variable | Default | Notes |
|----------|---------|-------|
| `DISPLAY_NAME` | `MorpheusUI` | Window/title text |

## Pairing with a custom proxy-router

Most consumer setups use the proxy-router that the MorpheusUI desktop app downloads and starts itself. To point the UI at a separate proxy-router (e.g. a Docker container or a remote C-Node):

1. Stop the managed proxy-router (quit the app, or stop it from the startup screen).
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`](https://github.com/MorpheusAIs/Morpheus-Lumerin-Node/blob/main/docs/ui-desktop.all.env).