Skip to content

Admin Dashboard

Vein serves a web dashboard - package catalog, quarantine review, SBOM inspection - on its own listener next to the proxy, built in with the admin Cargo feature (on by default).

vein serve --config vein.toml starts it alongside the proxy whenever [admin] enabled is true (the default):

[admin]
enabled = true
host = "127.0.0.1" # default; anything else needs trusted_networks or a token
port = 9400 # default

Browse to http://127.0.0.1:9400.

RubyGems names and the gems cached here, with their versions and platforms - needs the gems Cargo feature. crates.io and npm are planned to follow.

/quarantine shows quarantine stats and lets you approve or block versions without touching the CLI. See Quarantine for the policy this controls.

Scope today: SBOMs are generated for cached RubyGems. The roadmap extends generation to crates.io and npm.

  • Admin dashboard: browse to http://127.0.0.1:9400/catalog/<gem>?version=<version> to preview the generated SBOM and download the JSON.

  • Proxy endpoint: fetch it directly from the running proxy without the admin UI:

    GET /.well-known/vein/sbom?name=<gem>&version=<version>[&platform=<platform>]

    Returns a CycloneDX 1.5 document (Content-Type: application/json) with a download-friendly filename. Omit platform for the default ruby build; supply it for native variants (e.g. arm64-darwin).

SBOMs are generated automatically the first time a gem is cached, and refreshed whenever the gem is re-fetched.

The same listener mounts /mcp for coding agents - resources over the cache, plus code-context tools when configured. See MCP for the full reference, including the access model for a non-loopback bind.