Configuration

gmux works out of the box with no configuration. Everything is customizable through three config files in ~/.config/gmux/:

File	Purpose	Reference
host.toml	Daemon behavior: port, Tailscale remote access	host.toml →
settings.jsonc	Terminal options, keybinds, UI preferences	settings.jsonc →
theme.jsonc	Terminal color palette (Windows Terminal theme compatible)	theme.jsonc →

All files are optional. Create or edit them manually. The only exception is gmuxd remote, which can add [tailscale] to host.toml with your confirmation.

Settings and theme changes take effect on browser refresh (no daemon restart needed). Host config changes require restarting gmuxd.

More reference

• File paths — config files, sockets, runtime state, logs
• CLI commands — gmux and gmuxd usage
• Environment variables — variables that affect gmux and variables set inside sessions