Toise documentation

The living map of your infrastructure. Toise is an open-source backend that maintains a live, queryable graph of your infrastructure — hosts, processes, network interfaces, addresses, routes, services, and the relationships between them — built entirely from OpenTelemetry entity events and designed so an AI assistant can answer an operator's questions about it directly.

Get started What is Toise?

• Installation

  ---

  Build the single Go binary and bring up toise-server in a couple of minutes — no cluster, no orchestrator, no external runtime.

  Install and run

• Configuration

  ---

  Configure listeners, storage, liveness and retention from a YAML file, environment variables, or flags — in that order of precedence.

  Configure toise-server

• Ingesting data

  ---

  Feed the graph with OTLP entity events from any OpenTelemetry producer. Toise runs no collectors of its own.

  OTLP ingestion

• Querying the graph

  ---

  Three surfaces over one read model: GraphQL for tools, MCP for AI assistants, and a zero-dependency debug UI for operators.

  Query surfaces

• Data model

  ---

  Entities, attributes, relations, and the bi-temporal change log — and how they map onto the OpenTelemetry entity data model.

  The data model

• What's new

  ---

  Release notes, breaking changes, and migration guides.

  Release notes

Pre-1.0 (alpha)

Toise binds to loopback with no authentication by default. For an exposed deployment, turn on bearer-token auth, TLS, and --production — see Authentication & TLS. Since 0.7.0 the public contracts are pinned and evolve additively; a breaking change ships only with a deprecation notice and a migration guide (see the API stability policy).