Business operating system for Claude Code — 57 skills, 21 agents, smart daemon. Unified inbox (WhatsApp/Email/Slack/Telegram), autonomous PR merge, full-AWS monitoring, revenue (Stripe+RevenueCat), e-commerce (Shopify), marketing (Klaviyo/Meta/GA4), voice (Bland/ElevenLabs), APM (Datadog/NewRelic/OTEL), YOLO mode.
Persistent browser-based desktop (noVNC over Tailscale)
Gives a headless box a GUI desktop you can reach from any browser on the tailnet — no VNC client, no SSH tunnel — and survives reboots. Host-agnostic — works on any headless Linux box.
Architecture
browser ──HTTPS (tailnet)──> tailscale serve ──> 127.0.0.1:6080
│ (novnc.service, --user)
▼
websockify ──WebSocket⇄VNC──> localhost:5901
│
▼
TigerVNC Xvnc :1 (vncserver@:1.service)
│
▼
GNOME desktop on display :1
Install
./setup-novnc-desktop.sh
Idempotent. It installs websockify (pip --user), clones noVNC to ~/noVNC,
installs + enables the novnc.service user unit, enables linger, ensures
vncserver@:1 is boot-enabled, fronts it with tailscale serve, and disables the
GNOME idle screen-lock.
Boot persistence — the four things that must be true
| Layer | Unit / setting | Why |
|---|---|---|
VNC server :1 |
vncserver@:1.service (system, enabled) |
starts the X/GNOME desktop |
noVNC proxy :6080 |
novnc.service (--user, enabled, Restart=always) |
bridges WS↔VNC + serves the web client |
| user-service-without-login | loginctl enable-linger $USER |
the --user unit starts at boot, no login needed |
| HTTPS front | tailscale serve --bg 6080 |
config persists in tailscaled state across reboots |
If any one is missing the desktop won't come back after reboot. Verify:
systemctl is-enabled vncserver@:1.service # enabled
systemctl --user is-enabled novnc.service # enabled
loginctl show-user "$USER" -p Linger # Linger=yes
sudo tailscale serve status # shows / -> 127.0.0.1:6080
Access
- Tailnet IP:
http://<tailscale-ip>:6080/vnc.html - MagicDNS:
https://<host>.<tailnet>.ts.net/vnc.html(viatailscale serve) - Connect, enter the VNC password.
The box has no public IP, so 0.0.0.0:6080 is effectively tailnet-only. Keep it
that way — do not tailscale funnel this (that would expose the desktop to the
public internet).
Secrets (NOT in this repo)
- VNC password —
~/.vnc/passwd(TigerVNC obfuscated, 8-char max). Reset:printf '%s\n' '<pw>' | vncpasswd -f > ~/.vnc/passwd - Desktop login password — the Unix user password (
passwd/chpasswd). - GNOME login keyring — separate from the above; if its password is unknown,
launch Chromium/Brave with
--password-store=basicto avoid a keyring unlock hang (saved credentials won't decrypt, but the browser runs).
Troubleshooting
- noVNC loads but won't connect →
systemctl --user restart novnc.service; checkvncserver@:1is active and:5901is listening. tailscale servedenied → run withsudo, orsudo tailscale set --operator=$USERonce.- Only one process should
LISTENon:6080— the service one. Kill strays by PID.