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: record the security-suite extraction + email/cloudflare frontend relocations

Juan Denisab828d31e641
diff --git a/CHANGELOG.md b/CHANGELOG.md
index ea62b0de..6ca38ad8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -19,6 +19,30 @@ and the project aims to follow [Semantic Versioning](https://semver.org/spec/v2.
The `dev` branch is well ahead of the last `main` release. The headline work
awaiting a stable release:
+### Changed
+
+- **The security suite is now five installable extensions.** ClamAV/YARA
+ malware scanning and quarantine (`serverkit-clamav`), Fail2ban management
+ (`serverkit-fail2ban`), Lynis host audits (`serverkit-lynis`), automatic
+ security updates (`serverkit-auto-updates`) and container image CVE/SBOM
+ scanning (`serverkit-image-scan`) left the core panel for standalone
+ extensions installed from the Marketplace. Installed, they mount the same
+ `/api/v1/security/...` routes and the same Security-page tabs as before —
+ nothing about the surface changes. Not installed, a fresh panel's Security
+ page is a lean baseline (overview, firewall, SSH keys, IP lists, file
+ integrity, audit, events, settings) with no install nags. Panels upgrading
+ with the host tool already present get the matching extension installed
+ automatically once its registry entry is live. The setup wizard now asks
+ how much security tooling to install (minimal / recommended / hardened).
+ The panel core keeps fail2ban status probing and the per-site jail
+ write-half, so Setup Health, the security audit and per-site brute-force
+ jails work with or without the extensions.
+
+- **Email Server and Cloudflare Zone Ops frontends moved into their
+ extensions** (with their own API clients), the final in-tree step before
+ those extensions move to standalone repos. Core keeps the DNS-provider
+ connections and the Settings → Connections relay tile.
+
### Fixed
- **Adding a server to the fleet works again on Docker installs.** The panel
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index 601eb0ad..30e1e074 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -295,6 +295,20 @@ Source lives in this repo under `builtin-extensions/`:
> schema stays core forever — the **core data seam** (plan 52 D1, see
> EXTENSIONS.md "Data models & policy").
+> **The security suite left core the same way** (plan 47 Ph3b-4 / plan 55
+> Phase 3): `serverkit-clamav` (ClamAV+YARA scanning, quarantine),
+> `serverkit-fail2ban` (management surface — status probing + the per-site
+> jail write-half stay core on `Fail2banJailService`), `serverkit-lynis`,
+> `serverkit-auto-updates`, and the headless `serverkit-image-scan`
+> (CVE/SBOM; `image_vulnerability_scans`/`sbom_artifacts` stay core tables).
+> Each mounts its routes back at the `/api/v1/security` prefix and
+> contributes tabs into the Security tab group (`groupId="security"`), so an
+> installed extension is indistinguishable from the pre-split page. The core
+> Security page keeps only the zero-host-package baseline: overview,
+> firewall, SSH keys, IP lists, integrity, audit, events, settings.
+> Upgrade parity: `extension_migration.run_registry_auto_install()` installs
+> each from the registry once when the matching host tool is present.
+
### Standalone extension repos
These have their own repos and install from the registry as versioned,
diff --git a/docs/CORE_SLIM.md b/docs/CORE_SLIM.md
index e93f35b6..97f37eb4 100644
--- a/docs/CORE_SLIM.md
+++ b/docs/CORE_SLIM.md
@@ -49,11 +49,11 @@ cheaply. Sizes are the core page's current line count (the UI to relocate).
|---|---|---|---:|---|
| 1 | ✅ `serverkit-gpu` | ~~`GpuMonitor.jsx`~~ | 199 | **DONE (plan 32 #7, 2026-07-06).** Backend moved to `builtin-extensions/serverkit-gpu/backend` (`entry_point gpu:gpu_bp`, `url_prefix /api/v1/gpu`); page moved to `frontend/components/GpuMonitor.jsx` (SDK imports); core page + core `app/api/gpu.py` + `app/services/gpu_service.py` deleted; `sdk_version ^1.0.0` declared. Shipped **baked** (dual-path per guardrail below); runtime-ESM build scaffold added, live runtime-loader render deferred with plan 32 #9. |
| 2 | `serverkit-cloud-provision` | `CloudProvision.jsx` | 239 | One page; leans on connection APIs already in core. |
-| 3 | `serverkit-cloudflare-ops` | `CloudflareZoneSettings.jsx` | 469 | Zone-scoped; shares the CF client with core DNS (keep client in core/SDK). |
+| 3 | ✅ `serverkit-cloudflare-ops` | ~~`CloudflareZoneSettings.jsx`~~ | 469 | **DONE (plan 52 Ph2 prep, 2026-08-29).** Page + WAF/Workers/Tunnels/Storage panels + own API client + SCSS moved into `builtin-extensions/serverkit-cloudflare-ops/frontend/`; DNS records + CF connection stay core. Standalone repo prepared (operator publishes). |
| 4 | `serverkit-remote-access` | `RemoteAccess.jsx` | 516 | WireGuard pairing UI; agent-fleet coupling via SDK. |
| 5 | `serverkit-ftp` | `FTPServer.jsx` | 687 | Accounts CRUD; self-contained once helpers move with it. |
| 6 | `serverkit-status` | `StatusPages.jsx` | 747 | Has a **public** status route (`/status/:slug`) that must stay reachable — verify the public path still resolves post-move. |
-| 7 | `serverkit-email` | `Email.jsx` | 1086 | Large; a heavy vertical (the module-toggle candidate list). Migrate after the smaller ones prove the recipe. |
+| 7 | ✅ `serverkit-email` | ~~`Email.jsx`~~ | 1086 | **DONE (plan 52 Ph2 prep, 2026-08-29).** Page + own API client + SCSS moved into `builtin-extensions/serverkit-email/frontend/`; DNS-provider + relay methods stay core (Settings surfaces). Standalone repo prepared (operator publishes). |
| 8 | `serverkit-workflows` | `WorkflowBuilder.jsx` | 1092 | Largest Tier B; pulls in `@xyflow/react` — externalize it or bundle it into the extension (it is NOT a host-shared lib). |
| 9 | `serverkit-git` | Git page group | — | Already plugin-contributed self-rendering (`sk-tabgroup` shell). Mostly a file-move; last in Tier B because its tab-group wiring is the closest analog to Tier C. |