Docs

Commands

Run them on the office computer, as the user that runs mobd. mobd --help lists them too.

Run mobd

Command	What it does
`mobd init`	Create ~/.mobd/config.json; never overwrites an existing file
`mobd start`	Start in the background (macOS LaunchAgent, Linux systemd user service)
`mobd start --login`	Start, and start again at login (macOS) or boot (Linux)
`mobd restart`	Reload the configuration and restart; keeps the login setting
`mobd stop`	Stop, and turn off starting at login. Linux: asks whether to close desktops (--close-desktops, --keep-desktops)
`mobd status`	Listening address and readiness checks
`mobd logs`	Follow the log (Ctrl-C to stop)
`mobd serve`	Run in the foreground
`mobd uninstall`	Close every desktop, stop mobd and remove its service; keeps settings and data
`mobd --version`	Print the version

Command	What it does
`mobd link`	One-use pairing link and QR code (10 minutes) for the remote address, else the office network one
`mobd link --lan`	The same, always for the office network address
`mobd link --url URL`	The same, for exactly this address
`mobd link --close`	Cancel invitations that were not used yet
`mobd clients list`	List paired devices
`mobd clients revoke ID`	Revoke a device and disconnect it now
`mobd clients delete ID`	Revoke a device and remove its record
`mobd connections`	List active authenticated requests and streams
`mobd auth reset --yes`	Revoke every device and invitation

Command	What it does
`mobd remote`	Show remote access and check it reaches this mobd
`mobd remote setup`	Set up Tailscale Serve or a Cloudflare Tunnel (asks before each command)
`mobd remote setup --tailscale --yes`	The same, without questions
`mobd remote setup --cloudflare …`	Cloudflare, without questions (full command below)
`mobd remote off`	Turn remote access off; paired devices stay paired

mobd remote setup --cloudflare --hostname mob.example.com --token TOKEN --yes

Command	What it does
`mobd desktops list`	Every conversation desktop and its state
`mobd desktops doctor`	Check programs, cgroup v2, encoder, browsers, memory, disk and linger
`mobd desktops wake SESSION`	Wake a sleeping desktop
`mobd desktops close SESSION`	Close a desktop; its files and browser profile are kept
`mobd desktops logs SESSION`	Show a desktop's logs
`mobd desktops seed SESSION`	Make this conversation's browser profiles the start of every new conversation's

Settings live in ~/.mobd/config.json (Configure agents). Every setting, with its default and environment variable, is in the configuration reference.