admin-api
Admin API Plugin
Section titled “Admin API Plugin”System metrics, service health, session management, and audit log API for your ɳSelf instance. Pro plugin.
Requires: Basic license tier or higher.
nself license set nself_pro_...
Install
Section titled “Install”nself license set nself_pro_xxxxx...nself plugin install admin-apiWhat It Does
Section titled “What It Does”Provides admin-only REST endpoints for monitoring and managing a running ɳSelf instance. Exposes service health checks, real-time system metrics, active session enumeration and revocation, and a queryable audit log. All endpoints require the ADMIN_API_SECRET header and are restricted at the Nginx layer.
Configuration
Section titled “Configuration”| Env Var | Default | Description |
|---|---|---|
ADMIN_API_PORT | 3212 | Admin API service port |
ADMIN_API_SECRET | none | Required bearer secret for all admin endpoints |
ADMIN_SESSION_RETENTION | 90 | Number of days to retain session records |
| Port | Purpose |
|---|---|
| 3212 | Admin API REST endpoints |
Database Tables
Section titled “Database Tables”2 tables added to your Postgres database:
np_admin_api_sessions: tracked admin session recordsnp_admin_api_audit_log: admin action audit trail
Nginx Routes
Section titled “Nginx Routes”| Route | Target | Notes |
|---|---|---|
/admin-api/ | Admin API | Restricted, authentication required |