Getting Started
NeXuS is a production-grade infrastructure control platform built with modern microservices architecture. It provides everything you need to run scalable web applications with observability, security, and AI integration built-in.
What is NeXuS?
NeXuS brings enterprise-level capabilities to your self-hosted environment:
- 11 microservices orchestrated with Docker Compose
- JWT authentication with token rotation and httpOnly cookies
- Cloudflare DNS management with full CRUD API
- MCP server for Claude Code / Claude Desktop integration
- Prometheus + Grafana observability stack
- WAF, CDN, and caching services
- Plan-based feature gating (Basic / Pro / Enterprise)
Prerequisites
- Docker 29+ and Docker Compose
- Node.js 25+ (for local development)
- Domain with Cloudflare DNS (optional but recommended)
Quick Start
# Clone the repository
git clone https://github.com/sebhosting/nexus.git
cd nexus
# Copy environment template
cp .env.example .env
# Edit .env with your credentials
nano .env
# Start all services
cd infrastructure/docker
docker compose up -d
# Check health status
curl http://localhost:4000/health
Service URLs
Once running, your services are available at:
| Service | URL |
|---|---|
| Frontend | https://nexus.sebhosting.com |
| API Gateway | https://api.sebhosting.com |
| Auth Service | https://auth.sebhosting.com |
| Grafana | https://grafana.sebhosting.com |
| MCP Server | https://mcp.sebhosting.com |
See the full services table for all 11 services.
Next Steps
- Architecture Overview — understand the system design
- API Reference — explore the REST API
- MCP Tools — integrate with Claude
- Deployment Guide — production setup