Skip to content

ServerKit is a lightweight, modern server control panel for managing web applications, databases, and services on your VPS or dedicated server. Built with Python/Flask backend and React frontend.

Update ROADMAP: bump version and reorganize plans

Juan Denisfb501af7e163
diff --git a/README.md b/README.md
index f3f53c29..6aec4e53 100644
--- a/README.md
+++ b/README.md
@@ -18,6 +18,7 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P
![Docker](https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=docker&logoColor=white)
[![Discord](https://img.shields.io/discord/1470639209059455008?style=for-the-badge&logo=discord&logoColor=white&label=Discord&color=5865F2)](https://discord.gg/ZKk6tkCQfG)
+[![GitHub Stars](https://img.shields.io/github/stars/jhd3197/ServerKit?style=flat-square&color=f5c542)](https://github.com/jhd3197/ServerKit/stargazers)
[![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.11+-3776AB.svg?style=flat-square&logo=python&logoColor=white)](https://python.org)
[![React](https://img.shields.io/badge/react-18-61DAFB.svg?style=flat-square&logo=react&logoColor=black)](https://reactjs.org)
@@ -41,55 +42,89 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P
## 🎯 Features
-### Apps & Containers
+### 🚀 Apps & Deployment
-🐘 **PHP / WordPress** — PHP-FPM 8.x with one-click WordPress installation
+**PHP / WordPress** — PHP-FPM 8.x with one-click WordPress installation
-🐍 **Python Apps** — Deploy Flask and Django with Gunicorn
+**Python Apps** — Deploy Flask and Django with Gunicorn
-🟢 **Node.js** — PM2-managed applications with log streaming
+**Node.js** — PM2-managed applications with log streaming
-🐳 **Docker** — Full container and Docker Compose management
+**Docker** — Full container and Docker Compose management
-🔑 **Environment Variables** — Secure, encrypted per-app variable management
+**Environment Variables** — Secure, encrypted per-app variable management
-### Infrastructure
+**Git Deployment** — GitHub/GitLab webhooks, auto-deploy on push, branch selection, rollback, zero-downtime deployments
-🌐 **Domain Management** — Nginx virtual hosts with easy configuration
+### 🏗️ Infrastructure
-🔒 **SSL Certificates** — Automatic Let's Encrypt with auto-renewal
+**Domain Management** — Nginx virtual hosts with easy configuration
-🗄️ **Databases** — MySQL/MariaDB and PostgreSQL support
+**SSL Certificates** — Automatic Let's Encrypt with auto-renewal
-🛡️ **Firewall (UFW)** — Visual firewall rule management
+**Databases** — MySQL/MariaDB and PostgreSQL with user management and query interface
-⏰ **Cron Jobs** — Schedule tasks with a visual editor
+**Firewall** — UFW/firewalld with visual rule management and port presets
-📁 **File Manager** — Browse and edit files via web interface
+**Cron Jobs** — Schedule tasks with a visual editor
-📡 **FTP Server** — Manage vsftpd users and access
+**File Manager** — Browse, edit, upload, and download files via web interface
-### Security
+**FTP Server** — Manage vsftpd users and access
-🔐 **Two-Factor Auth** — TOTP-based with backup codes
+**Backup & Restore** — Automated backups to S3, Backblaze B2, or local storage with scheduling, retention policies, and one-click restore
-🦠 **Malware Scanning** — ClamAV integration with quarantine
+**Email Server** — Postfix + Dovecot with DKIM/SPF/DMARC, SpamAssassin, Roundcube webmail, email forwarding rules
-📋 **File Integrity Monitoring** — Detect unauthorized file changes
+### 🔒 Security
-🚨 **Security Alerts** — Real-time threat notifications
+**Two-Factor Auth** — TOTP-based with backup codes
-🧱 **Fail2ban & SSH** — Brute force protection and SSH key management
+**Malware Scanning** — ClamAV integration with quarantine
-### Monitoring & Alerts
+**File Integrity Monitoring** — Detect unauthorized file changes
-📊 **Real-time Metrics** — CPU, RAM, disk, network monitoring via WebSocket
+**Fail2ban & SSH** — Brute force protection, SSH key management, IP allowlist/blocklist
-📈 **Uptime Tracking** — Historical server uptime data
+**Vulnerability Scanning** — Lynis security audits with reports and recommendations
-🔔 **Notifications** — Discord, Slack, Telegram, and generic webhooks
+**Automatic Updates** — unattended-upgrades / dnf-automatic for OS-level patching
-🖥️ **Multi-Server** — Agent-based remote server monitoring and management
+### 🖥️ Multi-Server Management
+
+**Agent-Based Architecture** — Go agent with HMAC-SHA256 authentication and real-time WebSocket gateway
+
+**Fleet Overview** — Centralized dashboard with server grouping, tagging, and health monitoring
+
+**Remote Docker** — Manage containers, images, volumes, networks, and Compose projects across all servers
+
+**API Key Rotation** — Secure credential rotation with acknowledgment handshake
+
+**Cross-Server Metrics** — Historical metrics with comparison charts and retention policies
+
+### 📊 Monitoring & Alerts
+
+**Real-time Metrics** — CPU, RAM, disk, network monitoring via WebSocket
+
+**Uptime Tracking** — Historical server uptime data and visualization
+
+**Notifications** — Discord, Slack, Telegram, email (HTML templates), and generic webhooks
+
+**Per-User Preferences** — Individual notification channels, severity filters, and quiet hours
+
+### 👥 Team & Access Control
+
+**Multi-User** — Admin, developer, and viewer roles with team invitations
+
+**RBAC** — Granular per-feature permissions (read/write per module)
+
+**SSO & OAuth** — Google, GitHub, OpenID Connect, and SAML 2.0 with account linking
+
+**Audit Logging** — Track all user actions with detailed activity dashboard
+
+**API Keys** — Tiered API keys (standard/elevated/unlimited) with rate limiting, usage analytics, and OpenAPI documentation
+
+**Webhook Subscriptions** — Event-driven webhooks with HMAC signatures, retry logic, and custom headers
---
@@ -215,15 +250,23 @@ See the [Installation Guide](docs/INSTALLATION.md) for step-by-step instructions
- [x] Databases — MySQL, PostgreSQL
- [x] File & FTP management
- [x] Monitoring & alerts — Metrics, webhooks, uptime tracking
-- [x] Security — 2FA, ClamAV, file integrity, Fail2ban
-- [x] Firewall — UFW integration
+- [x] Security — 2FA, ClamAV, file integrity, Fail2ban, Lynis
+- [x] Firewall — UFW/firewalld integration
- [x] Multi-server management — Go agent, centralized dashboard
- [x] Git deployment — Webhooks, auto-deploy, rollback, zero-downtime
-- [ ] Backup & restore — S3, Backblaze B2, scheduled backups
-- [ ] Email server — Postfix, Dovecot, DKIM/SPF/DMARC
-- [ ] Team & permissions — RBAC, audit logging
-- [ ] Mobile app — React Native with push notifications
-- [ ] Plugin marketplace — Extensions, custom widgets, themes
+- [x] Backup & restore — S3, Backblaze B2, scheduled backups
+- [x] Email server — Postfix, Dovecot, DKIM/SPF/DMARC, Roundcube
+- [x] Team & permissions — RBAC, invitations, audit logging
+- [x] API enhancements — API keys, rate limiting, OpenAPI docs, webhook subscriptions
+- [x] SSO & OAuth — Google, GitHub, OIDC, SAML
+- [x] Database migrations — Flask-Migrate/Alembic, versioned schema
+- [ ] Agent fleet management — Auto-upgrade, bulk ops, offline command queue
+- [ ] Cross-server monitoring — Fleet dashboard, anomaly detection, alerting
+- [ ] Agent plugin system — Extensible agent with custom metrics, commands, health checks
+- [ ] Server templates & config sync — Drift detection, compliance dashboards
+- [ ] Multi-tenancy — Workspaces, team isolation, per-workspace settings
+- [ ] DNS zone management — Cloudflare, Route53, DigitalOcean integrations
+- [ ] Status pages — Public status page, health checks, incident management
Full details: [ROADMAP.md](ROADMAP.md)
@@ -246,12 +289,15 @@ Full details: [ROADMAP.md](ROADMAP.md)
| Layer | Technology |
|-------|------------|
-| Backend | Python 3.11, Flask, SQLAlchemy, Flask-SocketIO |
-| Frontend | React 18, Vite, LESS |
+| Backend | Python 3.11, Flask, SQLAlchemy, Flask-SocketIO, Flask-Migrate |
+| Frontend | React 18, Vite, LESS, Recharts |
| Database | SQLite / PostgreSQL |
-| Web Server | Nginx, Gunicorn |
+| Web Server | Nginx, Gunicorn (GeventWebSocket) |
| Containers | Docker, Docker Compose |
-| Security | ClamAV, TOTP (pyotp), Cryptography |
+| Security | ClamAV, Lynis, Fail2ban, TOTP (pyotp), Fernet encryption |
+| Auth | JWT, OAuth 2.0, OIDC, SAML 2.0 |
+| Email | Postfix, Dovecot, SpamAssassin, Roundcube |
+| Agent | Go (multi-server), HMAC-SHA256, WebSocket |
---
@@ -263,7 +309,7 @@ Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) first.
fork → feature branch → commit → push → pull request
```
-**Priority areas:** Backup implementations, additional notification channels, UI/UX improvements, documentation.
+**Priority areas:** Agent plugin system, fleet management, DNS integrations, status pages, UI/UX improvements, documentation.
---
@@ -275,6 +321,12 @@ Join the Discord to ask questions, share feedback, or get help with your setup.
---
+## ⭐ Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=jhd3197/ServerKit&type=Date)](https://star-history.com/#jhd3197/ServerKit&Date)
+
+---
+
<div align="center">
**ServerKit** — Simple. Modern. Self-hosted.
diff --git a/ROADMAP.md b/ROADMAP.md
index b4271464..0d3c7e9c 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -4,17 +4,15 @@ This document outlines the development roadmap for ServerKit. Features are organ
---
-## Current Version: v0.9.0
+## Current Version: v1.5.0 (In Development)
-### Recently Completed
+### Recently Completed (v1.4.0)
-- **Two-Factor Authentication (2FA)** - TOTP-based with backup codes
-- **Notification Webhooks** - Discord, Slack, Telegram, generic webhooks
-- **ClamAV Integration** - Malware scanning with quarantine
-- **File Integrity Monitoring** - Baseline creation and change detection
-- **Environment Variable Management** - Secure, encrypted per-app variables
-- **Cron Job Management** - Visual cron editor
-- **Server Uptime Tracking** - Historical uptime data and visualization
+- **Team & Permissions** - RBAC with admin/developer/viewer roles, invitations, audit logging
+- **API Enhancements** - API keys, rate limiting, webhook subscriptions, OpenAPI docs, analytics
+- **SSO & OAuth Login** - Google, GitHub, OIDC, SAML with account linking
+- **Database Migrations** - Flask-Migrate/Alembic with versioned schema migrations
+- **Email Server Management** - Postfix, Dovecot, DKIM, SpamAssassin, Roundcube
---
@@ -117,7 +115,7 @@ This document outlines the development roadmap for ServerKit. Features are organ
---
-## Phase 10: Multi-Server Management (In Progress)
+## Phase 10: Multi-Server Management (Completed)
**Priority: High**
@@ -137,7 +135,7 @@ This document outlines the development roadmap for ServerKit. Features are organ
---
-## Phase 11: Git Deployment (Planned)
+## Phase 11: Git Deployment (Completed)
**Priority: High**
@@ -180,44 +178,32 @@ This document outlines the development roadmap for ServerKit. Features are organ
---
-## Phase 14: Advanced SSL Features (Planned)
+## Phase 14: Team & Permissions (Completed)
**Priority: Medium**
-- [ ] Wildcard SSL certificates
-- [ ] Multi-domain certificates (SAN)
-- [ ] Custom certificate upload
-- [ ] Certificate expiry monitoring
-- [ ] Automatic renewal notifications
+- [x] Multi-user support
+- [x] Role-based access control (RBAC)
+- [x] Custom permission sets
+- [x] Audit logging per user
+- [x] Team invitations
+- [x] Activity dashboard
---
-## Phase 15: Team & Permissions (Planned)
+## Phase 15: API Enhancements (Completed)
**Priority: Medium**
-- [ ] Multi-user support
-- [ ] Role-based access control (RBAC)
-- [ ] Custom permission sets
-- [ ] Audit logging per user
-- [ ] Team invitations
-- [ ] Activity dashboard
+- [x] API key management
+- [x] Rate limiting
+- [x] Webhook event subscriptions
+- [x] OpenAPI/Swagger documentation
+- [x] API usage analytics
---
-## Phase 16: API Enhancements (Planned)
-
-**Priority: Medium**
-
-- [ ] API key management
-- [ ] Rate limiting
-- [ ] Webhook event subscriptions
-- [ ] OpenAPI/Swagger documentation
-- [ ] API usage analytics
-
----
-
-## Phase 17: Advanced Security (Completed)
+## Phase 16: Advanced Security (Completed)
**Priority: High**
@@ -233,88 +219,350 @@ This document outlines the development roadmap for ServerKit. Features are organ
---
-## Phase 18: Performance Optimization (Planned)
+## Phase 17: SSO & OAuth Login (Completed)
-**Priority: Low**
+**Priority: High**
-- [ ] Redis caching integration
-- [ ] Database query optimization
-- [ ] Static asset CDN support
-- [ ] Lazy loading for large datasets
-- [ ] Background job queue (Celery)
+- [x] Google OAuth 2.0 login
+- [x] GitHub OAuth login
+- [x] Generic OpenID Connect (OIDC) provider support
+- [x] SAML 2.0 support for enterprise environments
+- [x] Social login UI (provider buttons on login page)
+- [x] Account linking (connect OAuth identity to existing local account)
+- [x] Auto-provisioning of new users on first SSO login
+- [x] Configurable SSO settings (enable/disable providers, client ID/secret management)
+- [x] Enforce SSO-only login (disable password auth for team members)
+- [x] SSO session management and token refresh
---
-## Phase 19: Mobile App (Planned)
+## Phase 18: Database Migrations & Schema Versioning (Completed)
-**Priority: Low**
+**Priority: High**
-- [ ] React Native mobile application
-- [ ] Push notifications
-- [ ] Quick actions (restart, view stats)
-- [ ] Biometric authentication
+### Backend — Migration Engine
+- [x] Integrate Flask-Migrate (Alembic) for versioned schema migrations
+- [x] Generate initial migration from current model state as baseline
+- [x] Replace `_auto_migrate_columns()` hack with proper Alembic migrations
+- [x] Store schema version in a `schema_version` table (current version, history)
+- [x] API endpoints for migration status, apply, and rollback
+- [x] Auto-detect pending migrations on login and flag the session
+- [x] Pre-migration automatic DB backup before applying changes
+- [x] Migration scripts for all existing model changes (retroactive baseline)
+
+### CLI Fallback
+- [x] CLI commands for headless/SSH scenarios (`flask db upgrade`, `flask db status`)
+- [x] CLI rollback support (`flask db downgrade`)
---
-## Phase 20: Marketplace & Extensions (Planned)
+# Upcoming Development
-**Priority: Low**
+The phases below are ordered by priority. Higher phases ship first.
-- [ ] Plugin/extension system
-- [ ] Community marketplace
-- [ ] Custom dashboard widgets
-- [ ] Theme customization
+---
+
+## Phase 19: New UI & Services Page (Planned)
+
+**Priority: Critical**
+
+Merge the `new-ui` branch — adds a full Services page with service detail views, metrics, logs, shell, settings, git connect, and package management.
+
+- [ ] Merge `new-ui` branch into main development line
+- [ ] Services list page with status indicators and quick actions
+- [ ] Service detail page with tabbed interface (Metrics, Logs, Shell, Settings, Commands, Events, Packages)
+- [ ] Git connect modal for linking services to repositories
+- [ ] Gunicorn management tab for Python services
+- [ ] Service type detection and type-specific UI (Node, Python, PHP, Docker, etc.)
+- [ ] Resolve any conflicts with features added since branch diverged
---
-## Phase 21: SSO & OAuth Login (Completed)
+## Phase 20: Customizable Sidebar & Dashboard Views (Planned)
**Priority: High**
-- [x] Google OAuth 2.0 login
-- [x] GitHub OAuth login
-- [x] Generic OpenID Connect (OIDC) provider support
-- [x] SAML 2.0 support for enterprise environments
-- [x] Social login UI (provider buttons on login page)
-- [x] Account linking (connect OAuth identity to existing local account)
-- [x] Auto-provisioning of new users on first SSO login
-- [x] Configurable SSO settings (enable/disable providers, client ID/secret management)
-- [x] Enforce SSO-only login (disable password auth for team members)
-- [x] SSO session management and token refresh
+Let users personalize what they see. Not everyone runs email servers or manages Docker — the sidebar should adapt to each user's needs.
+
+- [ ] Sidebar configuration page in Settings
+- [ ] Preset view profiles: **Full** (default, all modules), **Web Hosting** (apps, domains, SSL, databases, files), **Email Admin** (email, DNS, security), **Docker/DevOps** (containers, deployments, git, monitoring), **Minimal** (apps, monitoring, backups only)
+- [ ] Custom view builder — toggle individual sidebar items on/off
+- [ ] Per-user preference storage (saved to user profile, synced across sessions)
+- [ ] Sidebar sections collapse/expand with memory
+- [ ] Quick-switch between saved view profiles
+- [ ] Admin can set default view for new users
+- [ ] Hide empty/unconfigured modules automatically (e.g., hide Email if no email domains exist)
---
-## Phase 22: Database Migrations & Schema Versioning (Planned)
+## Phase 21: Migration Wizard Frontend UI (Planned)
**Priority: High**
-Matomo-style update wizard — when the user logs in after an update and there are pending migrations, a popup/wizard guides them through the process visually.
+The backend migration engine is complete — this adds the visual upgrade experience (Matomo-style).
-### Backend — Migration Engine
-- [ ] Integrate Flask-Migrate (Alembic) for versioned schema migrations
-- [ ] Generate initial migration from current model state as baseline
-- [ ] Replace `_auto_migrate_columns()` hack with proper Alembic migrations
-- [ ] Store schema version in a `schema_version` table (current version, history)
-- [ ] API endpoint to check migration status (`GET /api/v1/system/migrations`)
-- [ ] API endpoint to run pending migrations (`POST /api/v1/system/migrations/apply`)
-- [ ] API endpoint to rollback last migration (`POST /api/v1/system/migrations/rollback`)
-- [ ] Auto-detect pending migrations on login and flag the session
-- [ ] Pre-migration automatic DB backup before applying changes
-- [ ] Migration scripts for all existing model changes (retroactive baseline)
-
-### Frontend — Update Wizard UI
- [ ] Full-screen modal/wizard that appears when pending migrations are detected
- [ ] Step 1: "Update Available" — show current version vs new version, changelog summary
- [ ] Step 2: "Backup" — auto-backup the database, show progress, confirm success
- [ ] Step 3: "Apply Migrations" — run migrations with real-time progress/log output
- [ ] Step 4: "Done" — success confirmation with summary of changes applied
- [ ] Error handling: if a migration fails, show the error and offer rollback option
-- [ ] Block access to the panel until migrations are applied (like Matomo does)
+- [ ] Block access to the panel until migrations are applied
- [ ] Migration history page in Settings showing all past migrations and timestamps
-### CLI Fallback
-- [ ] CLI commands for headless/SSH scenarios (`flask db upgrade`, `flask db status`)
-- [ ] CLI rollback support (`flask db downgrade`)
+---
+
+## Phase 22: Container Logs & Monitoring UI (Planned)
+
+**Priority: High**
+
+The container logs API is already built. This phase adds the frontend and extends monitoring to per-app metrics.
+
+- [ ] Log viewer component with terminal-style display and ANSI color support
+- [ ] Real-time log streaming via WebSocket with auto-scroll (pause on user scroll)
+- [ ] Log search with regex support and match highlighting
+- [ ] Filter by log level (INFO, WARN, ERROR, DEBUG) and time range
+- [ ] Export filtered logs to file
+- [ ] Per-container resource collection (CPU %, memory, network I/O via Docker stats API)
+- [ ] Per-app resource usage charts (Recharts) with time range selector (1h, 6h, 24h, 7d)
+- [ ] Per-app alert rules (metric, operator, threshold, duration)
+- [ ] Alert notifications via existing channels (email, Discord, Telegram) with cooldown
+
+---
+
+## Phase 23: Agent Fleet Management (Planned)
+
+**Priority: High**
+
+Level up agent management from "connect and monitor" to full fleet control.
+
+- [ ] Agent version tracking and compatibility matrix (panel version ↔ agent version)
+- [ ] Push agent upgrades from the panel (single server or fleet-wide rollout)
+- [ ] Staged rollout support — upgrade agents in batches with health checks between waves
+- [ ] Agent health dashboard — connection uptime, heartbeat latency, command success rate per agent
+- [ ] Auto-discovery of new servers on the local network (mDNS/broadcast scan)
+- [ ] Agent registration approval workflow (admin must approve before agent joins fleet)
+- [ ] Bulk agent operations — restart, upgrade, rotate keys across selected servers
+- [ ] Agent changelog and release notes visible in UI
+- [ ] Offline agent command queue — persist commands and deliver when agent reconnects
+- [ ] Command retry with configurable backoff for failed/timed-out operations
+- [ ] Agent connection diagnostics — test connectivity, latency, firewall check from panel
+
+---
+
+## Phase 24: Cross-Server Monitoring Dashboard (Planned)
+
+**Priority: High**
+
+Fleet-wide visibility — see everything at a glance and catch problems early.
+
+- [ ] Fleet overview dashboard — heatmap of all servers by CPU/memory/disk usage
+- [ ] Server comparison charts — overlay metrics from multiple servers on one graph
+- [ ] Per-server alert thresholds (CPU > 80% for 5 min → warning, > 95% → critical)
+- [ ] Anomaly detection — automatic baseline learning, alert on deviations
+- [ ] Custom metric dashboards — drag-and-drop widgets, save layouts per user
+- [ ] Metric correlation view — spot relationships between metrics across servers
+- [ ] Capacity forecasting — trend-based predictions (disk full in X days, memory growth rate)
+- [ ] Metrics export — Prometheus endpoint (`/metrics`), CSV download, JSON API
+- [ ] Grafana integration guide and pre-built dashboard templates
+- [ ] Fleet-wide search — find which server is running a specific container, service, or port
+
+---
+
+## Phase 25: Agent Plugin System (Planned)
+
+**Priority: High**
+
+Make the agent extensible — let users add custom capabilities without modifying agent core. This is the foundation for future integrations (Android device farms, IoT fleets, custom hardware monitoring, etc.).
+
+### Plugin Architecture
+- [ ] Plugin specification — standard interface (init, healthcheck, metrics, commands)
+- [ ] Plugin manifest format (YAML/JSON) — name, version, dependencies, capabilities, permissions
+- [ ] Plugin lifecycle management — install, enable, disable, uninstall, upgrade
+- [ ] Plugin isolation — each plugin runs in its own process/sandbox with resource limits
+- [ ] Plugin communication — standardized IPC between plugin and agent core
+
+### Plugin Capabilities
+- [ ] Custom metrics reporters — plugins can push arbitrary metrics to the panel
+- [ ] Custom health checks — plugins define checks that feed into the status system
+- [ ] Custom commands — plugins register new command types the panel can invoke
+- [ ] Scheduled tasks — plugins can register periodic jobs (cron-like)
+- [ ] Event hooks — plugins can react to agent events (connect, disconnect, command, alert)
+
+### Panel Integration
+- [ ] Plugin management UI — install, configure, monitor plugins per server
+- [ ] Plugin marketplace / registry — browse and install community plugins
+- [ ] Plugin configuration editor — per-server plugin settings from the panel
+- [ ] Plugin logs and diagnostics — view plugin output and errors
+- [ ] Plugin metrics visualization — custom widgets for plugin-reported data
+
+### Developer Experience
+- [ ] Plugin SDK (Go module) — scaffolding, helpers, testing tools
+- [ ] Plugin template repository — quickstart for new plugin development
+- [ ] Local plugin development mode — hot-reload, debug logging
+- [ ] Plugin documentation and API reference
+
+---
+
+## Phase 26: Server Templates & Config Sync (Planned)
+
+**Priority: Medium**
+
+Define what a server should look like, apply it, and detect when it drifts.
+
+- [ ] Server template builder — define expected state (packages, services, firewall rules, users, files)
+- [ ] Template library — save and reuse templates (e.g., "Web Server", "Database Server", "Mail Server")
+- [ ] Apply template to server — install packages, configure services, set firewall rules via agent
+- [ ] Config drift detection — periodic comparison of actual vs. expected state
+- [ ] Drift report UI — visual diff showing what changed and when
+- [ ] Auto-remediation option — automatically fix drift back to template (with approval toggle)
+- [ ] Template versioning — track changes to templates over time
+- [ ] Template inheritance — base template + role-specific overrides
+- [ ] Bulk apply — roll out template changes across server groups
+- [ ] Compliance dashboard — percentage of fleet in compliance per template
+
+---
+
+## Phase 27: Multi-Tenancy & Workspaces (Planned)
+
+**Priority: Medium**
+
+Isolate servers by team, client, or project. Essential for agencies, MSPs, and larger teams.
+
+- [ ] Workspace model — isolated container for servers, users, and settings
+- [ ] Workspace CRUD — create, rename, archive workspaces
+- [ ] Server assignment — each server belongs to exactly one workspace
+- [ ] User workspace membership — users can belong to multiple workspaces with different roles
+- [ ] Workspace switching — quick-switch dropdown in the header
+- [ ] Per-workspace settings — notification preferences, default templates, branding
+- [ ] Workspace-scoped API keys — API keys restricted to a single workspace
+- [ ] Cross-workspace admin view — super-admin can see all workspaces and usage
+- [ ] Workspace usage quotas — limit servers, users, or API calls per workspace
+- [ ] Workspace billing integration — track resource usage per workspace for invoicing
+
+---
+
+## Phase 28: Advanced SSL Features (Planned)
+
+**Priority: Medium**
+
+- [x] Certificate expiry monitoring
+- [ ] Wildcard SSL certificates via DNS-01 challenge
+- [ ] Multi-domain certificates (SAN)
+- [ ] Custom certificate upload (key + cert + chain)
+- [ ] Certificate expiry notifications (email/webhook alerts before expiration)
+- [ ] SSL configuration templates (modern, intermediate, legacy compatibility)
+- [ ] SSL health check dashboard (grade, cipher suites, protocol versions)
+
+---
+
+## Phase 29: DNS Zone Management (Planned)
+
+**Priority: Medium**
+
+Full DNS record management with provider API integration.
+
+- [ ] DNS zone editor UI (A, AAAA, CNAME, MX, TXT, SRV, CAA records)
+- [ ] Cloudflare API integration (list/create/update/delete records)
+- [ ] Route53 API integration
+- [ ] DigitalOcean DNS integration
+- [ ] DNS propagation checker (query multiple nameservers)
+- [ ] Auto-generate recommended records for hosted services (SPF, DKIM, DMARC, MX)
+- [ ] DNS template presets (e.g., "standard web hosting", "email hosting")
+- [ ] Bulk record import/export (BIND zone file format)
+
+---
+
+## Phase 30: Nginx Advanced Configuration (Planned)
+
+**Priority: Medium**
+
+Go beyond basic virtual hosts — full reverse proxy and performance configuration.
+
+- [ ] Visual reverse proxy rule builder (upstream servers, load balancing methods)
+- [ ] Load balancing configuration (round-robin, least connections, IP hash)
+- [ ] Caching rules editor (proxy cache zones, TTLs, cache bypass rules)
+- [ ] Rate limiting at proxy level (per-IP, per-route)
+- [ ] Custom location block editor with syntax validation
+- [ ] Header manipulation (add/remove/modify request/response headers)
+- [ ] Nginx config syntax check before applying changes
+- [ ] Config diff preview before saving
+- [ ] Access/error log viewer per virtual host
+
+---
+
+## Phase 31: Status Page & Health Checks (Planned)
+
+**Priority: Medium**
+
+Public-facing status page and automated health monitoring.
+
+- [ ] Automated health checks (HTTP, TCP, DNS, SMTP) with configurable intervals
+- [ ] Public status page (standalone URL, no auth required)
+- [ ] Status page customization (logo, colors, custom domain)
+- [ ] Service grouping on status page (e.g., "Web Services", "Email", "APIs")
+- [ ] Incident management — create, update, resolve incidents with timeline
+- [ ] Uptime percentage display (24h, 7d, 30d, 90d)
+- [ ] Scheduled maintenance windows with advance notifications
+- [ ] Status page subscribers (email/webhook notifications on incidents)
+- [ ] Historical uptime graphs
+- [ ] Status badge embeds (SVG/PNG for README files)
+
+---
+
+## Phase 32: Server Provisioning APIs (Planned)
+
+**Priority: Medium**
+
+Spin up and manage cloud servers directly from the panel.
+
+- [ ] DigitalOcean API integration (create/destroy/resize droplets)
+- [ ] Hetzner Cloud API integration
+- [ ] Vultr API integration
+- [ ] Linode/Akamai API integration
+- [ ] Server creation wizard (region, size, OS, SSH keys)
+- [ ] Auto-install ServerKit agent on provisioned servers
+- [ ] Server cost tracking and billing overview
+- [ ] Snapshot management (create/restore/delete)
+- [ ] One-click server cloning
+- [ ] Destroy server with confirmation safeguards
+
+---
+
+## Phase 33: Performance Optimization (Planned)
+
+**Priority: Low**
+
+- [ ] Redis caching for frequently accessed data (metrics, server status)
+- [ ] Database query optimization and slow query logging
+- [ ] Background job queue (Celery or RQ) for long-running tasks
+- [ ] Lazy loading for large datasets (paginated API responses)
+- [ ] WebSocket connection pooling and reconnection improvements
+- [ ] Frontend bundle optimization and code splitting
+
+---
+
+## Phase 34: Mobile App (Future)
+
+**Priority: Low — v3.0+**
+
+- [ ] React Native or PWA mobile application
+- [ ] Push notifications for alerts and incidents
+- [ ] Quick actions (restart services, view stats, acknowledge alerts)
+- [ ] Biometric authentication (fingerprint/Face ID)
+- [ ] Offline mode with cached server status
+
+---
+
+## Phase 35: Marketplace & Extensions (Future)
+
+**Priority: Low — v3.0+**
+
+- [ ] Plugin/extension system with API hooks
+- [ ] Community marketplace for plugins
+- [ ] Custom dashboard widgets
+- [ ] Theme customization (colors, layout, branding)
+- [ ] Extension SDK and developer documentation
---
@@ -322,14 +570,19 @@ Matomo-style update wizard — when the user logs in after an update and there a
| Version | Target Features | Status |
|---------|-----------------|--------|
-| v0.9.0 | Core features, 2FA, Notifications, Security | Current |
-| v1.0.0 | Production-ready stable release, DB migrations | Planned |
-| v1.1.0 | Multi-server, Git deployment | Planned |
-| v1.2.0 | Backups, Advanced SSL, Advanced Security | Planned |
-| v1.3.0 | Email server, API enhancements | Planned |
-| v1.4.0 | Team & permissions, SSO & OAuth login | Planned |
-| v1.5.0 | Performance optimizations | Planned |
-| v2.0.0 | Mobile app, Marketplace | Future |
+| v0.9.0 | Core features, 2FA, Notifications, Security | Completed |
+| v1.0.0 | Production-ready stable release, DB migrations | Completed |
+| v1.1.0 | Multi-server, Git deployment | Completed |
+| v1.2.0 | Backups, Advanced SSL, Advanced Security | Completed |
+| v1.3.0 | Email server, API enhancements | Completed |
+| v1.4.0 | Team & permissions, SSO & OAuth login | Completed |
+| v1.5.0 | New UI, customizable sidebar, migration wizard UI | Current |
+| v1.6.0 | Container monitoring UI, agent fleet management | Planned |
+| v1.7.0 | Cross-server monitoring, agent plugin system | Planned |
+| v1.8.0 | Server templates, multi-tenancy | Planned |
+| v1.9.0 | Advanced SSL, DNS management, Nginx config | Planned |
+| v2.0.0 | Status pages, server provisioning, performance | Planned |
+| v3.0.0 | Mobile app, Marketplace | Future |
---
@@ -338,10 +591,10 @@ Matomo-style update wizard — when the user logs in after an update and there a
Want to help? See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
**Priority areas for contributions:**
-- Multi-server agent development
-- Git webhook integration
-- S3/B2 backup implementations
-- Additional notification channels
+- Agent plugin SDK and example plugins
+- Fleet management and monitoring dashboard
+- DNS provider integrations (Cloudflare, Route53)
+- Status page and health check system
- UI/UX improvements
- Documentation