Skip to content

detent-authority

detent-authority --authority CONFIG [--daemonize | --status] [--runtime-dir PATH] [--config PATH]
[--port N] [--reactors N] [--system]
detent-authority --status [--port N]

The durable authority daemon. It reads the authority configuration at CONFIG and listens on port 8317 unless --port says otherwise (0 binds a free port and logs it).


OptionDefaultMeaning
--authority CONFIGrequiredThe authority configuration file
--port N8317HTTP port
--reactors N4Network reactor threads
--config PATHplatform config dirUse this detent-authority.json
--runtime-dir PATHplatform runtime dirWhere pid and log files go
--systemSystem config and runtime directories
--daemonizeRun in the background
--statusQuery the local instance’s health and PID, then exit

PID and log filenames include the port, so several instances can share one runtime directory.


VariableOverrides
DETENT_AUTHORITY_PORTport
DETENT_AUTHORITY_REACTORSreactors
DETENT_AUTHORITY_RUNTIME_DIRruntime_dir

detent-authority.json lives in the same directories as agent.json:

{
"authority": "/etc/detent/authority.json",
"port": 8317,
"reactors": 4,
"runtime_dir": "/run/detent",
"log_level": "info",
"verbosity": 0,
"color": "auto"
}

All fields are optional except that --authority or the authority field must name a configuration to serve. Paths are relative to the file.


Terminal window
detent-authority --status --port 8317

Without --authority, --status probes 127.0.0.1 over plain HTTP. With --authority CONFIG it probes the publisher address in the configuration, and checks the HTTPS endpoint with CA and name verification when the publisher uses TLS. Either probe has a two-second deadline. A reachable instance prints its PID and the health body and exits 0; otherwise --status prints not reachable and exits 1.