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.

feat(panel): wire imports, database tools and quick wins into the app

Juan Denis91e6f5cb29cb
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4d296859..077cf52c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -28,6 +28,39 @@ awaiting a stable release:
### Added
+- **Import a site (migration pipeline)** — a 5-step wizard at `/imports`
+ (entry points on Services and WordPress) restores cPanel/WHM, DirectAdmin
+ and Hestia/Vesta backup archives onto ServerKit: the archive is analysed
+ into a report (domains, databases, DB users, crontab, warnings), then a
+ resumable job maps it to an app, managed databases (MySQL password hashes
+ preserved where the engine allows) and cron entries, with per-step logs and
+ retry-from-failed-step. Uploads and fetch-by-URL both supported, with SSRF
+ and archive-traversal guards throughout.
+- **WordPress: import over SSH** — point at any live WordPress site with SSH
+ credentials (`/wordpress/ssh-import`): probe shows the pinned host key and
+ site facts, then a job pulls the docroot, dumps the database through the
+ tunnel and rebuilds it as a managed site with the URL search-replaced.
+- **Database tools** — the Database Explorer gains a live processlist with
+ kill/terminate per server or container; a curated config tuner (RAM-aware
+ suggested values for vetted MySQL/PostgreSQL settings, applied with backups
+ and clean rollback, never auto-applied); managed database users tracked as
+ first-class rows; and one-click "Open in Adminer" SSO via a single-use,
+ five-minute shadow credential scoped to one database.
+- **Per-app resource limits** — CPU and memory limits are first-class fields
+ on an app (Settings → Resource Limits) showing live usage vs limit, applied
+ to the container without touching the user's own compose file.
+- **One-time login links** — admins can mint single-use, short-TTL,
+ optionally IP-bound login URLs from Settings → Users, for "log in and take
+ a look" support situations; links are hashed at rest and reaped hourly.
+- **Demo mode** — an opt-in flag that blocks every mutating API call with
+ `403 demo_mode` and offers seeded read-only credentials on the login page,
+ for running a public demo of a real panel.
+- **Cloud-metadata egress guard** — a default-on (opt-out) firewall rule
+ blocking app containers from 169.254.169.254, closing the SSRF-to-cloud-IAM
+ credential-theft class on cloud VPSes (Security → Firewall).
+- **Server speed test** — an on-demand download/upload/latency test on the
+ Monitoring page, using the Ookla/speedtest CLI when present with a
+ pure-Python fallback.
- **Extensions platform (Phase 7 — settings slot + manifest linting)** — extensions
can now contribute sections to the Settings page (a `settings.section` widget
slot rendered below the active tab), and `plugin.json` manifests are shape-checked
diff --git a/backend/app/__init__.py b/backend/app/__init__.py
index 071667af..28b5e39c 100644
--- a/backend/app/__init__.py
+++ b/backend/app/__init__.py
@@ -76,6 +76,10 @@ def create_app(config_name=None):
from app.middleware.security import register_security_headers
register_security_headers(app)
+ # Demo mode guard — config-gated (default off), blocks mutating API calls
+ from app.middleware.demo import init_demo_mode
+ init_demo_mode(app)
+
# Register API key authentication middleware
from app.middleware.api_key_auth import register_api_key_auth
register_api_key_auth(app)
@@ -163,6 +167,14 @@ def create_app(config_name=None):
from app.api.databases import databases_bp
app.register_blueprint(databases_bp, url_prefix='/api/v1/databases')
+ # Register blueprints - Managed DB users + Adminer SSO
+ from app.api.managed_db_users import managed_db_users_bp
+ app.register_blueprint(managed_db_users_bp, url_prefix='/api/v1/managed-databases')
+
+ # Register blueprints - Curated DB config tuner
+ from app.api.db_tuner import db_tuner_bp
+ app.register_blueprint(db_tuner_bp, url_prefix='/api/v1/db-tuner')
+
# Register blueprints - Monitoring & Alerts
from app.api.monitoring import monitoring_bp
app.register_blueprint(monitoring_bp, url_prefix='/api/v1/monitoring')
@@ -450,6 +462,14 @@ def create_app(config_name=None):
from app.api.ai import ai_bp
app.register_blueprint(ai_bp, url_prefix='/api/v1/ai')
+ # Register blueprints - Server speed test (Monitoring card)
+ from app.api.speed_test import speedtest_bp
+ app.register_blueprint(speedtest_bp, url_prefix='/api/v1/speedtest')
+
+ # Register blueprints - Site imports (panel migration pipeline)
+ from app.api.site_imports import site_imports_bp
+ app.register_blueprint(site_imports_bp, url_prefix='/api/v1/imports')
+
# Handle database migrations (Alembic) — must run before plugin loader
# since the loader queries the installed_plugins table.
with app.app_context():
@@ -566,6 +586,18 @@ def create_app(config_name=None):
ServerOnboardingService.register_jobs()
from app.services.preview_service import PreviewService
PreviewService.register_jobs()
+ from app.services.metadata_guard_service import MetadataGuardService
+ MetadataGuardService.register_jobs()
+ if not app.config.get('TESTING'):
+ MetadataGuardService.ensure() # converge the metadata egress rule (no-op when unsupported)
+ from app.services.speed_test_service import SpeedTestService
+ SpeedTestService.register_jobs()
+ from app.services import login_link_service
+ login_link_service.register_jobs()
+ from app.services.db_admin_sso_service import DbAdminSsoService
+ DbAdminSsoService.register_jobs()
+ from app.services.site_import_service import SiteImportService
+ SiteImportService.register_jobs()
start_job_system(app, seed=seed_builtin_schedules)
# Request body size limit
diff --git a/backend/app/jobs/builtin_handlers.py b/backend/app/jobs/builtin_handlers.py
index 2a092523..45b58260 100644
--- a/backend/app/jobs/builtin_handlers.py
+++ b/backend/app/jobs/builtin_handlers.py
@@ -341,3 +341,17 @@ def seed_builtin_schedules():
ScheduledJobService.ensure(
name, kind, interval_seconds=interval, startup_delay_seconds=delay,
)
+ # One-time login-link reaper — handler registered by
+ # login_link_service.register_jobs() at boot.
+ from app.services import login_link_service
+ ScheduledJobService.ensure(
+ login_link_service.REAP_SCHEDULE_NAME, login_link_service.REAP_JOB_KIND,
+ interval_seconds=3600, startup_delay_seconds=120,
+ )
+ # Adminer SSO shadow-credential reaper — handler registered by
+ # DbAdminSsoService.register_jobs() at boot.
+ from app.services import db_admin_sso_service
+ ScheduledJobService.ensure(
+ db_admin_sso_service.REAP_SCHEDULE_NAME, db_admin_sso_service.REAP_JOB_KIND,
+ interval_seconds=300, startup_delay_seconds=120,
+ )
diff --git a/backend/app/models/__init__.py b/backend/app/models/__init__.py
index 5f8f6fe2..8c961734 100644
--- a/backend/app/models/__init__.py
+++ b/backend/app/models/__init__.py
@@ -64,6 +64,9 @@ from app.notifications.models import Notification, NotificationDelivery
from app.models.email_provider import EmailProviderConnection
from app.models.system_event import SystemEvent
from app.models.domain_registration import DomainRegistration
+from app.models.login_link import LoginLink
+from app.models.managed_database_user import ManagedDatabaseUser
+from app.models.site_import import SiteImport
__all__ = [
'User', 'Application', 'Domain', 'EnvironmentVariable', 'EnvironmentVariableHistory',
@@ -104,4 +107,7 @@ __all__ = [
'ApplicationPreview', 'ApplicationPreviewSettings',
'ProxyStack',
'SiteBaseDomain',
+ 'LoginLink',
+ 'ManagedDatabaseUser',
+ 'SiteImport',
]
diff --git a/backend/tests/test_jobs.py b/backend/tests/test_jobs.py
index c62bf987..2b8b6fcd 100644
--- a/backend/tests/test_jobs.py
+++ b/backend/tests/test_jobs.py
@@ -178,10 +178,11 @@ class TestBuiltins:
assert len([k for k in kinds if k.startswith('builtin.')]) == 10
builtin_handlers.seed_builtin_schedules()
- assert ScheduledJob.query.count() == 10
+ # 10 builtin.* schedules + the login-link and SSO-credential reapers.
+ assert ScheduledJob.query.count() == 12
# Seeding twice doesn't duplicate.
builtin_handlers.seed_builtin_schedules()
- assert ScheduledJob.query.count() == 10
+ assert ScheduledJob.query.count() == 12
class TestApi:
diff --git a/frontend/src/App.jsx b/frontend/src/App.jsx
index 7ac46908..aef4a5be 100644
--- a/frontend/src/App.jsx
+++ b/frontend/src/App.jsx
@@ -26,6 +26,7 @@ import CronJobs from './pages/CronJobs';
import Security from './pages/Security';
import Services from './pages/Services';
import NewService from './pages/NewService';
+import ImportWizard from './pages/ImportWizard';
import ServiceDetail from './pages/ServiceDetail';
import Templates from './pages/Templates';
import Servers from './pages/Servers';
@@ -79,6 +80,7 @@ const PAGE_TITLES = {
'/setup': 'Setup',
'/services': 'Services',
'/services/new': 'New Service',
+ '/imports': 'Import a Site',
'/projects': 'Projects',
'/shared-variables': 'Shared Variables',
'/fleet-proxy': 'Fleet Proxy',
@@ -309,6 +311,7 @@ function AppRoutes() {
{/* Settings sub-section in the URL (e.g. .../settings/git)
so the Settings left-nav is shareable and survives a refresh. */}
<Route path="services/:id/:tab/:section" element={<ServiceDetail />} />
+ <Route path="imports" element={<ImportWizard />} />
<Route path="apps" element={<Navigate to="/services" replace />} />
<Route path="apps/:id" element={<LegacyAppRedirect />} />
<Route path="apps/:id/:tab" element={<LegacyAppRedirect />} />
diff --git a/frontend/src/services/api/index.js b/frontend/src/services/api/index.js
index f8d989af..1695fd5c 100644
--- a/frontend/src/services/api/index.js
+++ b/frontend/src/services/api/index.js
@@ -31,6 +31,11 @@ import * as projectMethods from './projects.js';
import * as sharedResourceMethods from './sharedResources.js';
import * as previewMethods from './previews.js';
import * as proxyMethods from './proxy.js';
+import * as metadataGuardMethods from './metadataGuard.js';
+import * as speedTestMethods from './speedtest.js';
+import * as dbProcessMethods from './dbProcesses.js';
+import * as dbTunerMethods from './dbTuner.js';
+import * as importMethods from './imports.js';
class ApiService extends ApiClient {
constructor() {
@@ -69,6 +74,11 @@ class ApiService extends ApiClient {
sharedResourceMethods,
previewMethods,
proxyMethods,
+ metadataGuardMethods,
+ speedTestMethods,
+ dbProcessMethods,
+ dbTunerMethods,
+ importMethods,
];
for (const mod of modules) {
for (const [key, fn] of Object.entries(mod)) {
diff --git a/frontend/src/styles/main.scss b/frontend/src/styles/main.scss
index 6b5e0830..6aeaa297 100644
--- a/frontend/src/styles/main.scss
+++ b/frontend/src/styles/main.scss
@@ -88,6 +88,8 @@
@import 'pages/_applications';
@import 'pages/_docker';
@import 'pages/_databases';
+@import 'pages/_db-processes';
+@import 'pages/_db-tuner';
@import 'pages/_domains';
@import 'pages/_monitoring';
@import 'pages/_backups';
@@ -113,6 +115,7 @@
@import 'pages/_email';
@import 'pages/_setup-wizard';
@import 'pages/_migration-wizard';
+@import 'pages/_import-wizard';
@import 'pages/_new-service';
@import 'pages/_services';
@import 'pages/_service-detail';