Install Wayseer.

1. Download the package for your platform from the table, and install it: Linux, macOS or Windows.
2. Get the demo world: wayseer-demo.zip (0.8 MB), a config file and a dozen CSV files describing a made-up company of 400 hosts and 120 services. Unpack it, and it makes a folder named demo.
3. Open it from the folder that holds demo: wayseer --config demo/config.yaml.
4. Then 1–8 or the bar across the top switch lenses, click an entity to focus it, Ctrl+K (⌘K on a Mac) finds anything, F1 hides the hints, Shift+F1 shows the tour, Ctrl+Q quits.
5. Your own systems: run wayseer with no flags. It writes a default config, with every option described in comments, and opens on this machine. Add a Prometheus, Proxmox VE, Kubernetes, SQL or file source and save (Kubernetes and SQL need a license key): the app reloads the config while it runs. Secrets are named, never stored: a file, an environment variable or the system keyring.

Downloads

Linux AppImage	wayseer-0.28.0-x86_64.AppImage x86-64, 19.6 MB, built 7 October 2026 SHA-256 d9b2d6bad58578770b5e747659ed907ce068030fb538d977f542efc7371cac4c
Linux tarball	wayseer-0.28.0-linux-x86_64.tar.gz x86-64, 20.7 MB, built 7 October 2026 SHA-256 e13e4c49e2430ea0ec4ef4dd443ed37e34f8cdc5039319fee2627dadaa0b74a4
Linux Flatpak	wayseer-0.28.0-x86_64.flatpak x86-64, 14.4 MB, built 7 October 2026 SHA-256 6b1c4f4733d4f12d1bd64ff13aeeb9887c831b8970c55056fa0b6c8dda6d92ad
macOS zip	wayseer-0.28.0-macos.zip Apple silicon and Intel, 39.4 MB, built 7 October 2026 SHA-256 1a50ba6166b68398673baa6ad569a25395a4dddfd6b15054aca7f476f96bf524
Windows zip	wayseer-0.28.0-windows-x86_64.zip x86-64, 20.1 MB, built 7 October 2026 SHA-256 73efe5d0fa482ee905d963b2b5dc91fafb070c3e341fdda6f03af6cec070f161
Windows MSI installer	wayseer-0.28.0-windows-x86_64.msi x86-64, 21.4 MB, built 7 October 2026 SHA-256 ae8ee95f46c2bf1ffa4849ed086162c639a9a3c33b9333768a152d67e107c421

What's new in 0.28.0

• Windows: a first run opens on this PC, with its CPUs, memory, drives, network, processes and services. A config from 0.27 needs its localhost entry uncommented.
• On macOS, >updates.install downloads the newer app and checks its signature. Y shows it in Finder; quit Wayseer and drag it over the old one. Wayseer never replaces the app itself. A 0.27 Mac only says 0.28.0 is out: download 0.28.0 from this page once.
• Something that starts after the first listing now shows a "started" event, on every platform.
• The AppImage now starts under NixOS's appimage-run.

The AppImage, tarball and Windows zip update themselves when you ask: Wayseer downloads the newer release, checks its signature, installs it only when you press Y, and keeps the one it replaced so you can undo it. A copy a package manager installed is left to it.

Packages

Linux	AppImage, tarball or Flatpak, x86-64, or the Nix package. About 20 MB. The primary platform.
macOS 13+	One app for Apple silicon and Intel. About 39 MB. untested on a Mac so far
Windows 10/11	An installer or a portable zip, x86-64. About 20 MB. untested on Windows so far

License

Free	Files, this machine, Prometheus with Alertmanager, Proxmox VE, Wayseer's own health, in one window.
With a key	Kubernetes and SQL, more than one window, control, MCP and the language model. Pricing, and how keys work.

Which one

AppImage	One file to download and run, with nothing installed and no menu entry.
Tarball	Wayseer in your application menu, under ~/.local or /opt.
Flatpak	Wayseer in a sandbox, on nearly any Linux. It sees only the files you let it, and doesn't update itself.
Nix	On Nix or NixOS, installed and updated with the rest of your system. From 0.27.2, tried on NixOS.

The AppImage and tarball are signed, and check the signature of each update they install. Check the Flatpak against the SHA256SUMS file beside it in the downloads: sha256sum -c --ignore-missing SHA256SUMS.

AppImage

chmod +x wayseer-*-x86_64.AppImage
./wayseer-*-x86_64.AppImage

It mounts itself with FUSE, which most desktops have (the fuse3 package). Without it, add --appimage-extract-and-run. Flags go after the file name.

Tarball

tar -xzf wayseer-*-linux-x86_64.tar.gz -C ~/.local --strip-components=1

It is laid out like /usr, so it unpacks straight into a prefix: wayseer lands in ~/.local/bin, with a menu entry and its icon. To remove it, delete ~/.local/bin/wayseer, ~/.local/lib/wayseer/, and the wayseer files under ~/.local/share.

Flatpak

flatpak install --user wayseer-*-x86_64.flatpak
flatpak run org.wayseer.Wayseer

Installing it fetches the Freedesktop runtime from Flathub. To update, install the newer file with --reinstall. Its config lives in ~/.var/app/org.wayseer.Wayseer/config/wayseer/, and it reads other files only once you allow them, such as flatpak override --user --filesystem=~/.kube:ro org.wayseer.Wayseer.

Nix

nix run github:wayseer-net/desktop-nix

It installs the signed tarball unchanged. On NixOS, add github:wayseer-net/desktop-nix to your inputs, include its nixosModules.default, and set programs.wayseer.enable = true;. Its README shows the whole configuration. It updates through Nix, never by itself.

1. Open the zip. Finder unpacks Wayseer.app beside it.
2. Drag Wayseer.app into Applications, and open it from there or Launchpad.

It needs no permission from System Settings to show this Mac: its CPUs, memory, filesystems, network interfaces and processes. From 0.28.0, >updates.install downloads the newer app and checks its signature, and Y shows it in Finder: quit Wayseer and drag it over the old one. A 0.27 copy only says a newer release is out, so download 0.28.0 from the table once. To remove it, drag it to the Trash; its config and state stay in ~/Library/Application Support/Wayseer/ until you delete that too.

The first time it opens

Until the app is signed with a Developer ID, macOS asks once before it opens.

macOS 15+	Open it, choose Done, then go to System Settings → Privacy & Security and choose Open Anyway beside Wayseer.
macOS 13, 14	Control-click the app in Finder, choose Open, then Open again.

From Terminal

/Applications/Wayseer.app/Contents/MacOS/wayseer --config my.yaml

Installer	The .msi installs into C:\Program Files\Wayseer\ and adds Wayseer to the Start menu, with an administrator's approval. A newer installer replaces the older version. Remove it in Settings → Apps.
Portable zip	Extract it anywhere and open wayseer.exe. Keep the files together: it finds SDL3.dll beside it. Remove it by deleting the folder.

A first run opens on this PC: its CPUs, memory, drives, network interfaces, processes and services, each service linked to its process and its dependencies. A config written by 0.27 keeps that entry commented out; remove the # before its two lines.

The first time it opens

Until the packages carry a code-signing certificate, Windows shows Windows protected your PC once. Choose More info, then Run anyway.

From a terminal

& "C:\Program Files\Wayseer\wayseer.exe" --help

It opens no console of its own, so the prompt comes back at once and its output follows.

Graphics	A Vulkan, Metal or Direct3D driver. Designed for a well-performing integrated GPU (Intel Xe or AMD RDNA class); a discrete GPU is never required. effects: low for weaker chips.
Memory	Aims to stay under memory_limit, default 1280 MiB, which holds about 250,000 entities with their history.
Network	None required. It talks to the sources your config names, and once a day fetches a public, signed list of withdrawn modules and new releases, the same file for everyone, sent with no identifier; your config can turn that off. It sends no telemetry, and checks a license key without a network.
Start	The first frame in about 50 ms on the reference laptop, about 100 ms in power-saving mode.

Where files live

Where each platform keeps its own apps' files. wayseer --help shows the full paths on your machine.

Config	Linux~/.config/wayseer/macOS~/Library/Application Support/Wayseer/Windows%APPDATA%\Wayseer\
State	Linux~/.local/state/wayseer/macOS~/Library/Application Support/Wayseer/Windows%LOCALAPPDATA%\Wayseer\
Logs	Linux~/.local/state/wayseer/macOS~/Library/Logs/Wayseer/Windows%LOCALAPPDATA%\Wayseer\Logs\

State holds bookmarks, the sources you turned off, and a license key once you add one. The logs record every question asked of a language model and every action run.

Something wrong? Report an issue, which is public: leave your hostnames, addresses and key out of it. Security problems, and anything you'd rather keep private, go to [email protected].