Port Registry
Port Registry — ɳSelf documentation.
Authoritative reservation list for every port used by the ɳSelf ecosystem. Generated from SPORT F10 (.claude/docs/sport/F10-PORT-REGISTRY.md) which audits every plugin manifest plus the standard ɳSelf stack defaults.
Reserved: web/ subapps + core
| Port | Service |
|---|---|
| 3010 | web/org (nself.org marketing, dev) |
| 3011 | web/docs (nself.org/docs, dev) |
| 3012 | web/chat (chat.nself.org marketing, dev) |
| 3013 | web/cloud (cloud.nself.org dashboard, dev) |
| 3014 | web/install (install.nself.org, dev) |
| 3015 | web/base (base.nself.org internal admin, dev) |
| 3016 | web/claw (claw.nself.org marketing, dev) |
| 3017 | web/task (task.nself.org marketing + free hosted live app, dev) |
| 3018 | web/nself (ntv.nself.org marketing, dev) |
| 3021 | admin (nself-admin local GUI) |
| 8001 | ping_api (web/backend CS_1, telemetry + license validation) |
| 3100 | Loki (monitoring) |
Stack Defaults: required + optional services
These are the canonical container ports for the ɳSelf stack (nself start). External access goes through nginx.
| Port | Service | Type |
|---|---|---|
| 5432 | PostgreSQL | Required |
| 8080 | Hasura GraphQL | Required |
| 4000 | Auth (nHost) | Required |
| 80 / 443 | nginx (reverse proxy / SSL) | Required |
| 9000 | MinIO (S3-compatible object storage) | Optional |
| 9001 | MinIO console | Optional |
| 6379 | Redis | Optional |
| 3000 | Functions (serverless runtime) | Optional |
| 5000 | MLflow | Optional |
| 1025 / 8025 | Mail (SMTP / web UI) | Optional |
| 7700 | MeiliSearch (Search) | Optional |
Plugin Port Range Conventions
| Range | Convention |
|---|---|
| 3010-3018 | Reserved, web/ subapps |
| 3021 | Reserved, admin |
| 3050-3074 | Free plugins, financial / scheduler / notify cluster |
| 3088-3129 | Pro plugins, media + content cluster |
| 3200-3217 | Free + Pro, VPN / discovery / observability cluster |
| 3300-3402 | Free + Pro, search / object-storage / chat / cms cluster |
| 3500-3603 | Pro, collaboration cluster (cms, social, livekit, calendar, devices) |
| 3700-3742 | Pro, claw + ai cluster |
| 8001 | Reserved, ping_api CS_1 |
Free Plugin Ports
Most of the 127 free plugins claim a port; config-type and sidecar plugins (monitoring, ollama, ci, e2ee, forgejo, family-gedcom, audit-log, github-runner) do not. Highlights:
| Port | Plugin | Notes |
|---|---|---|
| 3050 | backup |
PostgreSQL backup automation |
| 3051 | cron |
Free cron scheduler |
| 3052 | notify |
Email + webhook notifications |
| 3060 | webhooks |
Outbound webhook delivery |
| 3070 | stripe |
Stripe billing sync |
| 3071 | paypal |
PayPal sync |
| 3072 | shopify |
Shopify sync |
| 3074 | donorbox |
Donorbox sync |
| 3105 | jobs |
Background job queue |
| 3107 | tokens |
Signed content tokens |
| 3201 | torrent-manager |
Transmission/qBittorrent control |
| 3202 | content-acquisition |
Download orchestrator |
| 3302 | search |
MeiliSearch wrapper |
Two free plugins have no port (github-runner, monitoring, both run as bundles or agents).
Pro Plugin Ports
All 46 pro plugins claim a port. Sample:
| Port | Plugin | Tier |
|---|---|---|
| 3401 | chat |
pro |
| 3503 | livekit |
pro |
| 3709 | ai |
max |
| 3710 | claw |
max |
| 3711 | mux |
pro |
| 3719 | browser |
max |
| 3725 | claw-budget |
max |
Full per-plugin ports: see SPORT F10.
Known Conflicts (DRIFT: needs P93 resolution)
| Port | Reserved use | Plugin claim | Severity |
|---|---|---|---|
| 3010 | web/org (dev) |
idme plugin (pro) |
High |
| 3014 | web/install (dev) |
auth plugin (pro) |
High |
Workaround until plugin ports are reassigned: override via IDME_PLUGIN_PORT and AUTH_PLUGIN_PORT.
Source
- SPORT:
.claude/docs/sport/F10-PORT-REGISTRY.md - PPI:
~/Sites/nself§ Port Registry (Reserved) - Plugin manifests:
plugins/free/<name>/plugin.json,plugins-pro/paid/<name>/plugin.json