How emad60/nexusops works
NexusOps is a self-hosted infrastructure control plane: users manage a tenant-scoped fleet through a React SPA and FastAPI API, while enrolled agents report state and pull approved operations. Its operational loop spans telemetry, monitoring and incidents, notification, deployments, and HTTP domain routing; certificate issuance exists, but delivery or installation on nodes does not. Celery workers execute scheduled and queued work, with PostgreSQL for durable state and Redis for queues and event fan-out. Edges are limited to relationships documented in the README or shown in excerpts; several unsampled feature internals are represented by their enclosing source directories.
Main entry points: main.py REST API · celery_app.py Celery workers · agent.py Server and operations · routes.py Domain and route API
Components 22
User experience
- React SPA
frontend/src/App.tsx - API client
frontend/src/api/client.ts - WebSocket hub
backend/app/ws/hub.py
API and tenancy
- REST API
backend/app/main.py - Auth and tenancy
backend/app/api/deps.py - Tenant data model
backend/app/models/base.py
Fleet operations
- Node agent
agent/nexusops_agent.py - Server and operations
backend/app/api/v1/agent.py - Monitoring and incidents
backend/app/services/monitor_service.py - Notifications
backend/app/services/notification_service.py
Delivery and routing
- Domain and route API
backend/app/api/v1/routes.py - Deployment engine
backend/app/services/deployment_engine.py - Domain verification
backend/app/services/domain_service.py - Route configuration
backend/app/services/proxy_service.py - Certificate issuance
backend/app/services/certificate_issuance.py
Runtime infrastructure
- PostgreSQL
- Redis
- Event bus
backend/app/services/event_bus.py - Celery workers
backend/app/tasks/celery_app.py - Managed infrastructure
Other components
- Operator
- Email service
Connections 29
- Operator → React SPA: uses
- React SPA → API client: calls
frontend/src/App.tsx - API client → REST API: requests
- REST API → Auth and tenancy: resolves identity
backend/app/api/deps.py - Auth and tenancy → PostgreSQL: checks membership
- REST API → PostgreSQL: reads and writes
- REST API → Redis: uses
- REST API → Domain and route API: routes requests
backend/app/main.py - Domain and route API → Route configuration: calls
backend/app/api/v1/routes.py - Domain and route API → Domain verification: calls
backend/app/api/v1/routes.py - Node agent → Server and operations: reports heartbeat
- Server and operations → Node agent: returns pending work
- Server and operations → PostgreSQL: stores fleet state
- Celery workers → Redis: consumes queues
- Celery workers → PostgreSQL: reads and writes
- Celery workers → Monitoring and incidents: runs checks
- Monitoring and incidents → Notifications: raises and notifies
- Notifications → Email service: sends email
- Celery workers → Deployment engine: executes jobs
backend/app/services/deployment_engine.py - Deployment engine → Redis: streams logs
backend/app/services/deployment_engine.py - Domain verification → Route configuration: coordinates routes
backend/app/tasks/domain_routing.py - Route configuration → Node agent: ships nginx operations
- Domain verification → Managed infrastructure: verifies DNS
- Certificate issuance → Managed infrastructure: checks DNS propagation
- REST API → Event bus: publishes events
- Event bus → Redis: fans out events
backend/app/services/event_bus.py - Redis → WebSocket hub: feeds events
- WebSocket hub → React SPA: streams updates
- Tenant data model → PostgreSQL: maps records