← Install guide

Offline self-hosted

Totenvis runs entirely on your own network and never connects to anything outside it — not to us, not to the internet. This is the right choice if your estate can't reach the outside world at all, or you'd rather it didn't.

What you need before you start

  • A server, NAS or VM on your network that can run a container (Docker or a Kubernetes cluster), reachable from the subnets you want Totenvis to see.
  • A Totenvis account at account.totenvis.com, on a plan, with this install registered against it — that's where your licence file comes from.
  • Before this machine goes offline for good: your signed licence file, downloaded from your account while you still have a connection.
  • Optional, but worth having ready: a read-only SNMP community string for your switches and access points. Without one, those devices still turn up, just without the detail SNMP would add.

The steps to a running install

  1. Get the image. There's no self-serve way to pull it yet — the image lives on a private GitHub package today, and the customer registry we're building will let you sign in to your account, copy a pull token and docker login from there. Until it ships, contact us and we'll get you a build directly.

    Screenshot coming soon Your account page: the registry sign-in command and your pull token (coming soon)
  2. Start the Totenvis container — on Docker Compose, or the Helm chart if you're on Kubernetes — pointed at the network you want it to discover.

    Screenshot coming soon A terminal starting the container with docker compose up
  3. Open it in a browser. A brand-new install shows one screen: create the admin account.

    Screenshot coming soon The create-admin-account screen on first open
  4. A short first-run walk-through follows: which of the four ways this install is being run as (choose Offline self-hosted here), an SNMP community string, whether any of your network is cloud-managed, and how your devices are managed day to day. Every one of these is skippable and can be set up later.

    Screenshot coming soon The first-run walk-through's install-kind question
  5. Totenvis scans on its own from here. Open the Readiness tab to see what answered and what didn't, then the Topology tab for the map.

    Screenshot coming soon The Topology tab's map after the first sweep

Signing in for the first time

The admin account you create above is this install's own sign-in — separate from your account at account.totenvis.com, which holds your plan, your licence and your invoices rather than anything about your network. After that first screen, every visit to this install needs that admin sign-in (or an account it creates for someone else).

Adding your licence

An offline install never checks in anywhere, so its licence has to arrive as a file rather than a key: download the signed licence file from your account at account.totenvis.com before you cut this machine off, then upload it on the install's Licence panel (on the Readiness tab). Totenvis checks the file is genuinely yours and installs it — from then on, the date on that file is the only thing that can lapse this install. Before it runs out, download a renewed file and upload it the same way; there's no restart needed, and nothing is lost while you do.

Screenshot coming soon The Licence panel, uploading a signed licence file
Uploading a licence file issued for a different install is refused, naming both installs, rather than silently taking this one offline.