YuriHandbook

Advanced reference

Override the host's startup configuration

Use a small set of environment controls for binding, storage and runtime selection.

Environment values apply to the process that reads them. Setting a variable on your phone or in an unrelated terminal does not reconfigure the connected Yuri host. Restart the intended process after changing its startup environment.

Change how Yuri is reached or stored

VariablePurpose
YURI_HOSTThe web host's bind address. A wider bind changes network reachability.
YURI_UI_PASSWORDBrowser UI authentication password.
YURI_API_ONLYtrue or 1 keeps API service without serving the browser UI.
YURI_DATA_DIROverride Yuri's data directory, normally ~/.config/yuri.

Changing the data directory selects another storage location; it does not migrate the old contents. Set host access and authentication together when widening the bind address.

Select the execution environment

VariablePurpose
OPENCODE_HOSTAn HTTP(S) origin with an explicit port; no path, query or fragment. Takes precedence over OPENCODE_PORT.
OPENCODE_PORTExplicit OpenCode port selection.
OPENCODE_SKIP_STARTtrue selects the no-managed-start path.
OPENCODE_BINARYExplicit OpenCode executable selection.
YURI_TERMINAL_SHELLShell executable for Yuri terminal sessions.

Use the host guide for an external-runtime example. When a startup service captures environment variables, changing your current shell alone will not change that already-installed service.

This is an operator reference, not a list of every internal build or debug variable. Prefer the visible Settings controls for model, speech and appearance configuration.