plugin stream gateway - nself-org/cli GitHub Wiki
Stream Gateway Plugin
Stream admission control, viewer authentication, analytics, and family controls. Pro plugin.
Requires: Basic license tier or higher.
nself license set nself_pro_...
Install
nself license set nself_pro_xxxxx...
nself plugin install stream-gateway
What It Does
Acts as a gatekeeper between viewers and your streaming server. Validates viewer entitlements before allowing stream access, tracks concurrent viewer counts, collects per-viewer quality analytics (buffering, bitrate switches), and enforces family member controls such as content ratings and concurrent stream limits per account.
Configuration
| Env Var | Default | Description |
|---|---|---|
STREAM_GATEWAY_PORT |
3093 |
Stream gateway port |
STREAM_GATEWAY_MAX_STREAMS_PER_ACCOUNT |
3 |
Concurrent stream limit |
STREAM_GATEWAY_TOKEN_TTL |
3600 |
Viewer access token TTL |
STREAM_GATEWAY_GEO_ENABLED |
false |
Enable geo-restriction |
Ports
| Port | Purpose |
|---|---|
| 3093 | Stream gateway REST API |
Database Tables
4 tables added to your Postgres database:
np_stream_gateway_sessions, active viewer sessionsnp_stream_gateway_analytics, per-viewer quality metricsnp_stream_gateway_profiles, family member profilesnp_stream_gateway_restrictions, content access restrictions
Nginx Routes
| Route | Target |
|---|---|
/stream-gateway/ |
Stream gateway API |
/stream-gateway/admit |
Viewer admission endpoint |