Back to surfaces Linux · macOS

Web control center

A self-hosted owner web control center: one backend origin serves a Svelte single-page app and reports your hosts. It is a client over the public protocol, and the CLI and launchers keep working when it is down.

Experimental. The web control center works, but it needs a lot of love before it is pleasant to use every day. For daily work use the desktop companion, the Sway launchers or the terminal TUI.

Experimental · web-v0.3.1
Features

What it does

Session rail across hosts

A persistent workspace shell lists every host, groups normal work by project and promotes the sessions that need you.

Attach over WebSocket

The backend exposes a transparent control or attach WebSocket per daemon. The backend is not authoritative: each daemon still owns its sessions, events and notifications.

Mesh-local owner tool

It is meant for your own machines over the overlay. It is not the optional team relay.

Install

Get it running

Linux x86_64

Verified download, then install.sh puts the backend and the browser app under your XDG data directory and writes a systemd user unit. The backend binds only to your NetBird address.

shell
gh release download web-v0.3.1 -R zajca/pohunek-work -p 'pohunek-web-0.3.1-linux-x86_64.tar.gz*'
sha256sum -c pohunek-web-0.3.1-linux-x86_64.tar.gz.sha256
gh attestation verify pohunek-web-0.3.1-linux-x86_64.tar.gz --repo zajca/pohunek-work
tar -xzf pohunek-web-0.3.1-linux-x86_64.tar.gz
cd pohunek-web-0.3.1-linux-x86_64 && ./install.sh
$EDITOR ~/.config/pohunek/backend.env   # set POHUNEK_BACKEND_BIND_HOST (NetBird address) and POHUNEK_BACKEND_PORT
systemctl --user daemon-reload
systemctl --user enable --now pohunek-backend.service

macOS (Apple Silicon)

Then set the bind address and port in ~/.config/pohunek/backend.env and run the installer again, as the formula output describes.

shell
brew install zajca/pohunek/pohunek-web
Notes

Every surface is a client of the same public CLI and protocol. See the other surfaces or the docs. Project home: https://github.com/zajca/pohunek.