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.

docs: catch README/CHANGELOG/feature reference up to the unreleased dev work

Juan Denisae177d789c27
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9a2a8d4b..34088956 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -43,6 +43,35 @@ awaiting a stable release:
`/git`).
- **RHEL-family support** — the installer now covers Rocky, AlmaLinux, RHEL, and
CentOS in addition to Ubuntu/Debian/Fedora.
+- **Per-app Web Application Firewall** — ModSecurity v3 + OWASP Core Rule Set
+ with detect/block modes, paranoia tuning, a disabled-rule editor, one-click
+ apply (nginx include injection), and parsed audit-log events.
+- **Container lifecycle controls** — image-update detection with one-click
+ apply, idle container auto-sleep, and CPU-driven horizontal auto-scaling, with
+ cron-drivable sweeps for the sleep/scale policies.
+- **GPU monitoring** — NVIDIA utilization, memory, temperature, power, and
+ per-process / per-container usage.
+- **Dynamic DNS** — token-authenticated A/AAAA updates synced through a
+ connected DNS provider (e.g. Cloudflare).
+- **Secrets manager & inbound webhook gateway** — encrypted secret storage and
+ inbound webhook endpoints for triggering automation.
+- **Passkeys / WebAuthn** — passwordless and second-factor authentication with
+ hardware keys, Touch ID, and Windows Hello.
+- **Layout switcher** — full sidebar, compact rail, and top-bar shell variants.
+- **Guided installer / updater** — health-checked install and update flow with
+ automatic rollback.
+
+### Security
+
+- **Container CVE scanning & SBOM** — per-image vulnerability scans with grype
+ and software bill-of-materials generation with syft.
+- **Optional, hardened TLS** — best-effort HTTPS that never blocks an install
+ (falls back to HTTP), a server-wide TLS 1.2+/AEAD-cipher floor applied at
+ install and update, Cloudflare-aware nginx configs, automatic CAA records on
+ certificate issuance, and HSTS gated on the operator's recorded SSL choice so
+ HTTPS stays optional.
+- **Encryption at rest** — system-setting secrets and DNS/cloud provider
+ credentials sealed with Fernet; optional client-side backup encryption.
### Changed
diff --git a/README.md b/README.md
index 8bd97693..167a0b9d 100644
--- a/README.md
+++ b/README.md
@@ -56,15 +56,19 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P
**Docker** — Full container and Docker Compose management with real-time log streaming and terminal access
+**Container Lifecycle** — Image-update detection with one-click apply, auto-sleep for idle containers, and CPU-driven horizontal auto-scaling
+
**Marketplace** — Over 60+ one-click templates for popular apps (Immich, Ghost, Authelia, etc.)
### 🏗️ Infrastructure
**Domain Management** — Nginx virtual hosts with easy configuration
-**DNS Zone Management** — Full DNS record management with propagation checking (A, AAAA, CNAME, MX, TXT, etc.)
+**DNS Zone Management** — Full DNS record management with propagation checking (A, AAAA, CNAME, MX, TXT, CAA, etc.)
+
+**Dynamic DNS** — Token-authenticated A/AAAA updates for home servers and changing IPs, synced through your DNS provider
-**SSL Certificates** — Automatic Let's Encrypt with auto-renewal
+**SSL / TLS** — Automatic Let's Encrypt with auto-renewal, optional (best-effort) HTTPS that never blocks an install, hardened TLS 1.2+/AEAD ciphers, Cloudflare-aware configs, and automatic CAA records
**Databases** — MySQL/MariaDB and PostgreSQL with user management and query interface
@@ -78,7 +82,9 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P
**FTP Server** — Manage vsftpd users and access
-**Backup & Restore** — Automated backups to S3, Backblaze B2, or local storage with scheduling, retention policies, and one-click restore
+**Backup & Restore** — Automated backups to S3, Backblaze B2, or local storage with scheduling, retention policies, one-click restore, and optional client-side encryption
+
+**Secrets & Webhook Gateway** — Encrypted secrets store plus an inbound webhook gateway for triggering automation from external events
**Email Server** — Postfix + Dovecot with DKIM/SPF/DMARC, SpamAssassin, Roundcube webmail, email forwarding rules
@@ -86,6 +92,10 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P
**Two-Factor Auth** — TOTP-based with backup codes
+**Passkeys / WebAuthn** — Passwordless and second-factor sign-in with hardware keys, Touch ID, and Windows Hello
+
+**Web Application Firewall** — Per-app ModSecurity v3 + OWASP Core Rule Set with detect/block modes, tunable paranoia, and audit-log events
+
**Malware Scanning** — ClamAV integration with quarantine
**File Integrity Monitoring** — Detect unauthorized file changes
@@ -94,6 +104,10 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P
**Vulnerability Scanning** — Lynis security audits with reports and recommendations
+**Container CVE Scanning & SBOM** — Per-image vulnerability scanning with grype and software bill-of-materials generation with syft
+
+**Encrypted Secrets at Rest** — Provider credentials and system-setting secrets sealed with Fernet encryption
+
**Automatic Updates** — unattended-upgrades / dnf-automatic for OS-level patching
### 🖥️ Multi-Server Management
@@ -122,6 +136,8 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P
**Real-time Metrics** — CPU, RAM, disk, network monitoring via WebSocket
+**GPU Monitoring** — NVIDIA GPU utilization, memory, temperature, and power, with per-process and per-container usage
+
**Uptime Tracking** — Historical server uptime data and visualization
**Status Pages** — Public status pages with HTTP/TCP/DNS/Ping health checks, component monitoring, and incident management
@@ -148,6 +164,8 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P
### 🎨 Customization
+**Layout Switcher** — Switch the app shell between full sidebar, compact rail, and top-bar layouts
+
**Sidebar Presets** — Switch between Full, Web Hosting, Email Admin, DevOps, and Minimal views with one click
**Collapsible Navigation** — Sidebar groups auto-expand on navigation and collapse when switching sections
@@ -302,6 +320,14 @@ See the [Installation Guide](docs/INSTALLATION.md) for step-by-step instructions
- [x] Status pages — Public status pages with health checks, incident management
- [x] Cloud provisioning — DigitalOcean, Hetzner, Vultr, Linode with cost tracking
- [x] Customizable sidebar — Collapsible groups, view presets, accent colors, white-label branding
+- [x] Web Application Firewall — Per-app ModSecurity v3 + OWASP CRS
+- [x] Container security — Image CVE scanning (grype) + SBOM (syft)
+- [x] Passwordless auth — WebAuthn / passkeys
+- [x] Dynamic DNS — Token-authenticated A/AAAA updates
+- [x] GPU monitoring — NVIDIA utilization, memory, and processes
+- [x] Container lifecycle — Image-update apply, auto-sleep, horizontal auto-scaling
+- [x] TLS hardening — Optional HTTPS, Cloudflare-aware configs, automatic CAA
+- [x] Secrets manager & inbound webhook gateway
Full details: [ROADMAP.md](ROADMAP.md)
@@ -317,6 +343,7 @@ Full details: [ROADMAP.md](ROADMAP.md)
| [Agent](agent/README.md) | Install & run the multi-server agent (Linux/Windows/macOS) |
| [Agent Pairing](docs/pairing.md) | Secure short-code agent enrollment |
| [API Reference](docs/API.md) | REST API endpoints |
+| [New Features](docs/NEW_FEATURES.md) | Endpoint & page reference for the latest `dev` features |
| [Changelog](CHANGELOG.md) | Release history and notable changes |
| [Roadmap](ROADMAP.md) | Development roadmap and planned features |
| [Contributing](CONTRIBUTING.md) | How to contribute |
@@ -332,8 +359,8 @@ Full details: [ROADMAP.md](ROADMAP.md)
| Database | SQLite / PostgreSQL |
| Web Server | Nginx, Gunicorn (GeventWebSocket) |
| Containers | Docker, Docker Compose |
-| Security | ClamAV, Lynis, Fail2ban, TOTP (pyotp), Fernet encryption |
-| Auth | JWT, OAuth 2.0, OIDC, SAML 2.0 |
+| Security | ClamAV, Lynis, Fail2ban, ModSecurity v3 + OWASP CRS, grype, syft, TOTP (pyotp), Fernet encryption |
+| Auth | JWT, OAuth 2.0, OIDC, SAML 2.0, WebAuthn / passkeys |
| Email | Postfix, Dovecot, SpamAssassin, Roundcube |
| Agent | Go (multi-server), HMAC-SHA256, WebSocket |
diff --git a/docs/NEW_FEATURES.md b/docs/NEW_FEATURES.md
index 3df8f0ce..f837150d 100644
--- a/docs/NEW_FEATURES.md
+++ b/docs/NEW_FEATURES.md
@@ -1,9 +1,10 @@
# New Features — Endpoint & Page Reference
-Reference for the features added on `dev` (12 feature commits, `cd16d9a … 70883d5`).
-All endpoints are under `/api/v1`. "admin" = requires `user.is_admin`; "edit" =
-`_can_edit_app` (owner or admin); "auth" = any valid JWT. Tables auto-create on
-startup via `db.create_all()`.
+Reference for the features added on `dev` — the 12 UI/Docker/WAF feature commits
+(`cd16d9a … 70883d5`) plus the SSL/TLS hardening follow-up (`02afdec … a09bf0f`,
+see §6). All endpoints are under `/api/v1`. "admin" = requires `user.is_admin`;
+"edit" = `_can_edit_app` (owner or admin); "auth" = any valid JWT. Tables
+auto-create on startup via `db.create_all()`.
---
@@ -119,7 +120,58 @@ Requires a scale-capable compose service (no fixed host port / `container_name`)
---
-## 6. Known follow-ups
+## 6. SSL/TLS hardening & optional HTTPS (security follow-up — `02afdec … a09bf0f`)
+
+HTTPS is **optional and best-effort** — the installer never blocks on SSL, and the
+panel never forces it. Hardening is applied so that *when* TLS is served, it's
+strong; it stays inert in HTTP-only mode.
+
+**Install/update (`install.sh`, `scripts/update.sh`)**
+- Best-effort cert: tries Let's Encrypt (webroot); on failure falls back to plain
+ HTTP instead of failing the install. `SERVERKIT_SKIP_SSL=1` forces HTTP.
+- Two panel vhosts: `serverkit.conf` (HTTPS + HTTP→HTTPS redirect) and
+ `serverkit-insecure.conf` (HTTP-only). The choice persists to
+ `/etc/serverkit/ssl-mode` and is preserved across updates.
+- **Server-wide TLS floor**: `harden_global_tls()` rewrites/injects
+ `ssl_protocols TLSv1.2 TLSv1.3` + AEAD-only `ssl_ciphers` in the system
+ `nginx.conf` `http{}`, so the default server and any non-ServerKit vhost are
+ covered too. Edited in place to avoid nginx's duplicate-directive error on
+ Debian/Ubuntu. `update.sh` re-applies it to existing installs.
+- Cloudflare-aware configs (Origin CA option + dashboard guidance) in
+ `nginx/sites-available/*`.
+
+**Per-app vhosts (`services/nginx_service.py` `SSL_BLOCK`)** — HSTS
+(`includeSubDomains; preload`), CSP, `X-Content-Type-Options`, `X-Frame-Options`,
+`Referrer-Policy`, and `ssl_ecdh_curve`, in addition to the TLS 1.2/1.3 + AEAD set.
+
+**Auto-CAA on certificate issuance** — `ssl_service.obtain_certificate` calls
+`DNSProviderService.ensure_caa_record(domain)` (best-effort, never fails the cert).
+It creates `CAA 0 issue "letsencrypt.org"` at the **zone apex** via whichever
+connected provider manages the domain (Cloudflare / DigitalOcean / Route53), and
+degrades to manual instructions otherwise. Cloudflare/DigitalOcean need CAA's
+structured `data` object (not a flat string) — handled. The cert response gains a
+`caa: {created, provider, zone, record, …}` field. The default DNS zone
+`web-hosting` preset also seeds a CAA record.
+
+**HSTS gating (panel)** — the Flask security middleware emits HSTS **only when the
+deployment terminates real HTTPS**, resolved as `SSL_MODE` / `HSTS_ENABLED` in
+`config.py`. Behind nginx/Cloudflare, Flask can't tell real TLS from a Cloudflare
+Flexible edge via `X-Forwarded-Proto`, so it trusts the operator's recorded choice
+rather than the request scheme. The nginx edge emits HSTS independently in its
+secure server block.
+
+| Setting | Where | Purpose |
+|---|---|---|
+| `SERVERKIT_SKIP_SSL=1` | env (installer) | Skip HTTPS entirely; run on plain HTTP. |
+| `SERVERKIT_SSL_MODE` | env / `.env` | `secure`\|`insecure` — gates the panel's HSTS header. |
+| `/etc/serverkit/ssl-mode` | file | Persisted SSL mode (read by installer, updater, and `config._resolve_ssl_mode`). |
+| `/etc/serverkit/panel-domain` | file | Persisted panel domain so `update.sh` re-applies the cert path without the old (broken) `.env` scrape. |
+
+Proving tests: `backend/tests/test_dns_caa.py`, `backend/tests/test_security_headers.py`.
+
+---
+
+## 7. Known follow-ups
- Migration import (cPanel/CyberPanel) — not started; needs real archive samples.
- Backups: additional remote targets (WebDAV/Azure/Dropbox/SFTP), streaming