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(plan47): sync extension manifests, raise ratchet, changelog + docs

Juan Denis176141295f43
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7e8ff8b1..e3758661 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -29,6 +29,15 @@ awaiting a stable release:
force-install WordPress — it's offered in the wizard when the WordPress use
case is selected. Existing installs keep WordPress untouched.
+- **FTP, Cloud Provisioning, Remote Access, and Status Pages are now opt-in
+ extensions** — their backends moved out of core into
+ `serverkit-ftp`, `serverkit-cloud-provision`, `serverkit-remote-access`, and
+ `serverkit-status`, so a fresh panel that never uses them loads none of their
+ code or API surface. **Upgraders lose nothing:** a one-shot boot migration
+ re-acquires each extension's backend on panels that had installed it, and the
+ underlying data models stay in core. Uninstalling an extension now removes its
+ API surface too, not just its page.
+
- **Automations (tramo) replaces the Workflow Builder** — the drag-and-drop
React-Flow Workflow Builder is retired in favour of **Automations**
(`/automations`), an opt-in builtin extension that embeds
diff --git a/README.md b/README.md
index 1f7735de..dd711320 100644
--- a/README.md
+++ b/README.md
@@ -367,6 +367,8 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P
### 🎨 Customization
+**Lean by default** — The guided setup wizard installs only the extensions matched to the use cases you pick (WordPress, web apps, self-hosting, DevOps) and nothing else. Uncheck anything you don't want; add more anytime from Extensions. WordPress is offered at setup rather than force-installed.
+
**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
diff --git a/backend/tests/BASELINE_COUNT b/backend/tests/BASELINE_COUNT
index 8c9a94ce..13d7e774 100644
--- a/backend/tests/BASELINE_COUNT
+++ b/backend/tests/BASELINE_COUNT
@@ -1 +1 @@
-2588
+2623
diff --git a/docs/EXTENSIONS.md b/docs/EXTENSIONS.md
index 73d2a657..c4348beb 100644
--- a/docs/EXTENSIONS.md
+++ b/docs/EXTENSIONS.md
@@ -448,3 +448,30 @@ Proven with `serverkit-git`; automated by the one-shot upgrade auto-install
Existing panels auto-install converted builtins once on upgrade (a marker in
settings) so nothing disappears; fresh installs see them in the Marketplace.
+
+### Second speed — moving the backend out too (plan 47)
+
+Once a converted page has settled as a frontend-only extension, its backend
+blueprint + service can leave core:
+
+1. `git mv backend/app/api/<feature>.py builtin-extensions/<slug>/backend/<module>.py`
+ and the same for its service(s). Rewrite imports: **core** imports stay
+ absolute (`from app.middleware.rbac import …`), **sibling** extension modules
+ become relative (`from .<sibling> import …`).
+2. Add `backend/__init__.py` exposing the blueprint, and set the manifest's
+ `entry_point` (`"<module>:<bp>"`) + `url_prefix` (**unchanged** so frontend
+ API clients don't move).
+3. Deregister it from `backend/app/__init__.py` (drop the import + `register_blueprint`).
+4. Keep any **model** used by the extension in `backend/app/models/` (extensions
+ can't run migrations — G2). The extension imports it.
+5. If a **core** code path calls into the now-extracted service (a job handler,
+ the agent gateway), reach it through
+ `plugin_service.get_installed_extension_attr(slug, module, attr)` so it
+ no-ops cleanly when the extension is absent.
+6. Ensure the slug is in `extension_migration.CONVERTED_BUILTIN_SLUGS`. On an
+ upgraded panel that installed the extension **frontend-only** (its API used
+ to come from core), `run_backend_acquisition()` force-reinstalls once to
+ re-acquire the now-extracted backend — otherwise the API would vanish.
+
+Landed this way: `serverkit-ftp`, `serverkit-cloud-provision`,
+`serverkit-remote-access`, `serverkit-status`.
diff --git a/frontend/src/plugins/serverkit-cloud-provision/plugin.json b/frontend/src/plugins/serverkit-cloud-provision/plugin.json
index b06582e8..daa9cfc8 100644
--- a/frontend/src/plugins/serverkit-cloud-provision/plugin.json
+++ b/frontend/src/plugins/serverkit-cloud-provision/plugin.json
@@ -10,6 +10,8 @@
"permissions": [
"network"
],
+ "entry_point": "cloud_provisioning:cloud_provisioning_bp",
+ "url_prefix": "/api/v1/cloud",
"icon": "<path d=\"M17.5 19H9a7 7 0 1 1 6.71-9h1.79a4.5 4.5 0 1 1 0 9Z\"/>",
"contributions": {
"tabs": [
diff --git a/frontend/src/plugins/serverkit-ftp/plugin.json b/frontend/src/plugins/serverkit-ftp/plugin.json
index b7c5354d..0a55da71 100644
--- a/frontend/src/plugins/serverkit-ftp/plugin.json
+++ b/frontend/src/plugins/serverkit-ftp/plugin.json
@@ -11,6 +11,8 @@
"shell",
"filesystem"
],
+ "entry_point": "ftp:ftp_bp",
+ "url_prefix": "/api/v1/ftp",
"icon": "<rect x=\"16\" y=\"16\" width=\"6\" height=\"6\" rx=\"1\"/><rect x=\"2\" y=\"16\" width=\"6\" height=\"6\" rx=\"1\"/><rect x=\"9\" y=\"2\" width=\"6\" height=\"6\" rx=\"1\"/><path d=\"M5 16v-3a1 1 0 0 1 1-1h12a1 1 0 0 1 1 1v3\"/><path d=\"M12 12V8\"/>",
"contributions": {
"tabs": [
diff --git a/frontend/src/plugins/serverkit-remote-access/plugin.json b/frontend/src/plugins/serverkit-remote-access/plugin.json
index 901b4a42..2d3029d0 100644
--- a/frontend/src/plugins/serverkit-remote-access/plugin.json
+++ b/frontend/src/plugins/serverkit-remote-access/plugin.json
@@ -10,6 +10,8 @@
"permissions": [
"network"
],
+ "entry_point": "tunnels:tunnels_bp",
+ "url_prefix": "/api/v1/tunnels",
"icon": "<rect x=\"16\" y=\"16\" width=\"6\" height=\"6\" rx=\"1\"/><rect x=\"2\" y=\"16\" width=\"6\" height=\"6\" rx=\"1\"/><rect x=\"9\" y=\"2\" width=\"6\" height=\"6\" rx=\"1\"/><path d=\"M5 16v-3a1 1 0 0 1 1-1h12a1 1 0 0 1 1 1v3\"/><path d=\"M12 12V8\"/>",
"contributions": {
"tabs": [
diff --git a/frontend/src/plugins/serverkit-status/plugin.json b/frontend/src/plugins/serverkit-status/plugin.json
index 7d514dc3..9d782d44 100644
--- a/frontend/src/plugins/serverkit-status/plugin.json
+++ b/frontend/src/plugins/serverkit-status/plugin.json
@@ -2,12 +2,14 @@
"name": "serverkit-status",
"display_name": "Status Pages",
"version": "1.0.0",
- "description": "Public status pages backed by uptime monitors, with the management UI as a tab in the Observability group. The public /status/<slug> page itself stays core.",
+ "description": "Public status pages backed by uptime monitors, with the management UI as a tab in the Observability group. Installing the extension serves the public /status/<slug> and /status/badge/<slug> pages too.",
"author": "ServerKit",
"license": "MIT",
"category": "monitoring",
"homepage": "https://github.com/jhd3197/ServerKit",
"permissions": [],
+ "entry_point": "status_pages:status_pages_bp",
+ "url_prefix": "/api/v1/status",
"icon": "<circle cx=\"12\" cy=\"12\" r=\"10\"/><path d=\"M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20\"/><path d=\"M2 12h20\"/>",
"contributions": {
"tabs": [