Support

Getting started with StatGlance: adding servers, SSH keys, Secure Setup, desktop widgets and fixes for common connection problems.

Last updated: October 6, 2026

Contact

Questions, bug reports or feature requests: [email protected]

Requirements

  • macOS 15 or later
  • A Linux server you can reach over SSH (Debian, Ubuntu, RHEL, Alpine and other distributions with /proc)
  • SSH key authentication. StatGlance does not support passwords.

Getting started

  1. Open StatGlance. It starts with three simulated servers so you can look around.
  2. Click Manage Servers in the panel and add your server’s address and user name.
  3. Generate a new key in the app or import an existing OpenSSH key (ed25519 or RSA).
  4. Add the public key to the server, or use Secure Setup (below), then connect.

You can delete the simulated servers in Manage Servers at any time.

Secure Setup

Secure Setup creates a dedicated statglance user on your server that has no password, no sudo and can only run the read-only metrics script. Even if the key leaked, it could not be used for anything else.

  1. In the server editor, choose Secure Setup. The app creates a key and shows a one-line command.
  2. Connect to your server with ssh as a user with sudo rights.
  3. Paste and run the command on the server, not on your Mac.
  4. Back in the app, click Connect.

The setup script is public and can be reviewed before running it.

Widgets

Right-click the desktop, choose Edit Widgets… and search for “StatGlance”.

  • Server (small, medium): one server. Choose which one from the widget’s Edit menu.
  • All Servers (medium, large): every server at once.

Widgets are updated by the app, so StatGlance needs to be running. The app sends new data to widgets every 15 seconds, and macOS may refresh them less often, so widgets can lag behind the app. If a widget shows “not updating”, open StatGlance.

Troubleshooting

Connection fails. Check that you can connect with the same user and key from Terminal, that the public key is in ~/.ssh/authorized_keys on the server, and that the SSH port is reachable.

“Host key changed”. StatGlance remembers each server’s host key on first connection and refuses to connect if it changes. If you reinstalled the server or changed its key on purpose, open the server editor and click Forget Host Key. If you did not, do not connect: someone may be intercepting the connection.

Network speed looks wrong. StatGlance sums the physical interfaces and ignores loopback, container (Docker, Kubernetes) and VPN interfaces (WireGuard, Tailscale, ZeroTier, Netbird), whose traffic already crosses the physical interface.

Only Linux is supported. macOS, BSD and Windows servers do not have /proc and cannot be monitored.

Privacy

StatGlance has no accounts, analytics or tracking, and connects only to the servers you add. See the privacy policy.

Questions? Get in touch→