Jocasta¶

Jocasta keeps an inventory of the devices on your network. It logs every change. It is one binary, with a web UI, a JSON API and an MCP server.

Pre-1.0

A release can change the config format, the database schema or the API with no upgrade path. Pin a version. Before you move to a new version, read the upgrade notes. To read the docs for your release, select it in the version menu at the top.

The overview page

How it works¶

Jocasta sweeps the networks you list, every 5 minutes.
It records each device under its hardware address, because an IP address is only a lease.
It logs what changed.

To see other VLANs, add your router. To see traffic, add flow exports. To see lookups, add your DNS resolver.

Start here¶

Your first inventory

Run Jocasta, sweep your network, name a device, and get a message when it goes quiet. 10 minutes.
How Jocasta works

Devices, scans, sources and presence.
Plugins

Routers, flow exports, DNS resolvers.
Notifications

ntfy, signed webhooks, chat services.
MCP server and JSON API

For agents and scripts.
Configuration reference

Every setting, its type and default.

Get help¶

GitHub issues, or Fix common problems.

For language models: llms.txt lists every page as Markdown, and llms-full.txt holds them all in one file.