Tutorial 5: Laptop + Always-On Mac Mini

Sessions live on the Mini; your laptop and phone are clients. No manual host configuration — ccmux auto-discovers every ccmuxd on your tailnet.

On the Mini

# ~/.config/ccmux/config.toml
[daemon]
listen_tailnet = true
tailnet_port   = 7474

ccmux daemon install   # register ccmuxd under launchd so it survives reboot

On the laptop — nothing to do

ccmux   # the Mini already appears on the dashboard, tagged "discovered"

Every refresh, ccmux runs tailscale status --json, probes each online peer for ccmuxd /v1/health, and merges responders into the host list.

Devices panel

The Dashboard Devices panel shows each tailnet peer:

• peers running ccmuxd — version + “update available” if behind your build
• peers without ccmuxd — “ccmux not installed” hint
• phones / iPads — “connect via Moshi app” hint

Attaching to a remote session

ccmux execs ssh -t <host> -- tmux attach -t <name>. To use Mosh instead for a pinned host:

ccmux host add --mosh mini --addr mini.tailnet:7474

Mosh tolerates roaming and stalls — close the lid, walk away, reopen, session is still attached.

Keeping versions in sync

The Devices panel tags any peer that’s behind your build with “update available”. SSH in and run ccmux update to bring it in sync.

Spotted an error or something out of date? Edit this page on GitHub.