Production-ready web UI for the nself CLI - Enterprise-grade management interface for your self-hosted backend stack.
v1.0.11 is the current release featuring 198 fully functional pages, 60+ production-grade components, real-time updates, error handling, and security hardening.
- What is nself-admin?
- Key Features
- Quick Start
- Screenshots
- Documentation
- Technology Stack
- System Requirements
- Contributing
- Support
- License
ɳSelf Admin is a web-based administration interface that wraps the nself CLI. Instead of running commands in your terminal, you get a real-time dashboard to manage your self-hosted backend stack.
- Visual Interface - No need to memorize CLI commands
- Real-Time Updates - WebSocket-powered live monitoring
- Team Collaboration - Share access to your infrastructure
- Production-Ready - Enterprise-grade security and error handling
- Mobile-Friendly - Manage your stack from anywhere
- Zero Lock-In - Pure UI wrapper, all data stays with nself CLI
- Developers who prefer GUIs over command-line interfaces
- Teams who need shared access to infrastructure management
- DevOps Engineers managing multiple environments (dev, staging, prod)
- Startups who want production-grade tooling without complexity
- Anyone running the nself CLI and wanting a better UX
- Real-time service status monitoring
- One-click start/stop/restart controls
- Live container logs with ANSI support
- Resource usage metrics (CPU, memory, disk)
- Service dependency visualization
- Container shell access
- Full-featured SQL console with Monaco editor
- Backup creation and restoration wizard
- Automated backup scheduling
- Migration management (create, run, rollback)
- Schema browser with table visualization
- Query history and saved queries
- Export results (CSV, JSON)
- Query explain/analyze support
- Environment selector (Local, Dev, Staging, Production)
- Side-by-side configuration comparison
- Blue-green deployment strategy
- Canary deployment controls
- Preview environment generation
- One-click rollback
- Deployment history and audit log
- WebSocket-based live monitoring
- Server-sent events for long operations
- Live log streaming
- Real-time metrics dashboards
- Instant container status updates
- Bcrypt password hashing
- Session management with httpOnly cookies
- Environment-based access control (dev/staging/prod)
- Secrets management per environment
- Audit logging for all actions
- CSRF protection
- Rate limiting
- Local certificates via mkcert
- Let's Encrypt automation
- Certificate renewal automation
- Trust store management
- Multi-domain support
- Grafana dashboard integration
- Prometheus metrics viewer
- Loki log aggregation
- Custom metrics dashboards
- Performance profiling
- Uptime monitoring
- AWS (EC2, RDS, S3, Route53)
- Google Cloud Platform
- DigitalOcean
- Microsoft Azure
- Server provisioning wizard
- Multi-cloud deployment
- Cluster management
- Namespace viewer
- Pod monitoring and logs
- Helm chart management
- Service mesh integration
- Resource quotas and limits
# If you have nself installed
nself adminOpen http://localhost:3021 and follow the setup wizard.
docker run -d \
--name nself-admin \
-p 3021:3021 \
-v $(pwd):/workspace \
-v /var/run/docker.sock:/var/run/docker.sock \
nself/nself-admin:latest- Set Admin Password - Create your secure admin password
- Initialize Project - Run the 6-step setup wizard
- Start Services - Launch your backend stack
- Access Dashboard - Monitor and manage everything in real-time
That's it! You're ready to go.
Screenshots are coming in a future release. For a live tour, run nself admin start and open http://localhost:3021.
- User Guide - Step-by-step tutorials for common tasks
- Deployment Guide - Production deployment instructions
- Development Guide - Local development setup
- Architecture - System architecture and design
- API Reference - API documentation
- Migration Guide - Upgrading between versions
- Changelog - Release history
- Roadmap - Upcoming features
- Security - Security policies
- Troubleshooting - Common issues and solutions
- Framework: Next.js 16 with React 19
- Language: TypeScript 5.9 (strict mode)
- Styling: Tailwind CSS 4
- UI Components: Radix UI, Headless UI
- State Management: Zustand, SWR
- Real-Time: Socket.io (WebSocket)
- Code Editor: Monaco Editor
- Charts: Recharts
- Runtime: Node.js 18+
- Database: LokiJS (embedded)
- Authentication: bcryptjs
- Container: Docker 20+
- Testing: Jest, Playwright, Testing Library
- Linting: ESLint (strict)
- Formatting: Prettier
- Package Manager: pnpm 8+
- Node.js 18+
- pnpm 8+
- Docker 20+
- 4GB RAM minimum
- 10GB disk space
- Docker 20+
- 2GB RAM minimum
- 10GB disk space
- Linux/macOS/Windows (WSL2)
- Chrome/Edge 100+
- Firefox 100+
- Safari 15+
- Mobile browsers (iOS Safari, Chrome Mobile)
- Initial Load: < 1.5s on average connection
- API Response: < 100ms for most operations
- Real-Time Updates: < 50ms latency
- Lighthouse Score: 95+ across all metrics
- Bundle Size: Optimized with code splitting
| Variable | Description | Default |
|---|---|---|
NSELF_PROJECT_PATH |
Path to your nself project | /workspace |
| Variable | Description | Default |
|---|---|---|
PORT |
Server port | 3021 |
NODE_ENV |
Environment (development/production) | - |
ADMIN_VERSION |
Version displayed in UI | 1.0.0 |
Note: Admin password is stored securely in the internal database (nadmin.db), not in environment variables.
We welcome contributions! Here's how to get started:
# Clone repository
git clone https://github.com/nself-org/admin.git
cd nself-admin
# Install dependencies
pnpm install
# Run development server
PORT=3021 pnpm dev
# Run tests
pnpm test
# Type checking
pnpm run type-check
# Linting
pnpm run lint
# Format code
pnpm run format
# Build for production
pnpm run buildAll code must pass:
- TypeScript type checking (strict mode)
- ESLint (zero warnings, zero errors)
- Prettier formatting
- Unit tests (90%+ coverage target)
- E2E tests for critical flows
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make your changes
- Run quality checks (
pnpm run lint && pnpm run type-check && pnpm test) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
See Contributing for detailed guidelines.
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Security: See Security for reporting vulnerabilities
- Documentation: Full Documentation
- Multi-tenant support
- Advanced RBAC (role-based access control)
- Plugin marketplace
- Advanced analytics dashboard
- AI-powered troubleshooting
- Enhanced mobile app experience
See Roadmap for the full roadmap.
Admin is single-operator in v1.x. One password authenticates one operator with full access. There are no roles, no per-user MFA enrollment, and no multi-tenant user separation in the Admin UI. Hasura roles continue to govern data-layer permissions for end-users of your nSelf-powered apps. Multi-user Admin (role-based operator access) is planned for v1.2.0. See Admin Single-Operator Posture for details.
MIT - See LICENSE for details.
Built by nself · GitHub · Docker Hub
- Next.js - React framework
- Tailwind CSS - Utility-first CSS
- Radix UI - Headless components
- Socket.io - Real-time communication
- Monaco Editor - Code editor
- Recharts - Charting library
Star us on GitHub if you find ɳSelf Admin useful!