Skip to main content
plog serve starts the HTTP server, REST API, and web dashboard.

Usage

plog serve
plog serve --addr :8080
plog serve --api-keys "key1,key2"
plog serve --demo
plog serve --no-dashboard

Flags

FlagDefaultDescription
--addr:7600Listen address
--api-keysComma-separated API keys for Bearer token auth
--demofalseSeed sample data using a temporary database
--no-dashboardfalseAPI only, no web UI
--otlpfalseEnable OTLP trace receiver at POST /v1/traces
--db~/.provenlog/events.dbSQLite database path

Authentication

When started with --api-keys, all API endpoints require a Bearer token:
plog serve --api-keys "my-secret-key"
curl -H "Authorization: Bearer my-secret-key" http://localhost:7600/v1/events

Demo mode

plog serve --demo
Seeds 25 realistic events across 3 agents in a temporary database. Useful for previewing the dashboard without real data.

What’s included

  • REST API at /v1/* — see API Reference
  • Web Dashboard at / — see Dashboard
  • WebSocket at /v1/stream — live event streaming