NKS WebDev Console

Local development environment for Windows, macOS, and Linux that manages Apache, PHP, MySQL/MariaDB, SSL, mail catching, Redis, Node, Cloudflare tunnels and DNS for .local / .test domains. An alternative to MAMP PRO, XAMPP, WampServer and Laragon.

Features

🖥️ Cross-platform - Windows (NSIS + portable), macOS (DMG + ZIP, Apple Silicon), Linux (AppImage)
🧩 Plugin daemon - Apache, PHP, MySQL, MariaDB, SSL (mkcert), Mailpit, Redis, Node, Caddy, Cloudflare and Hosts editor loaded as isolated .NET 9 plugin DLLs
🐘 Per-site PHP - each site can pin its own PHP version, INI overrides (memory, timeouts, upload limits, Xdebug, OPcache, extensions) and Apache Fcgid timeouts
🚚 MAMP PRO migration - importer reads MAMP PRO's SQLite database, recreates vhosts, copies SSL certs and migrates databases (verified on 17 sites + 66 databases)
🎛️ Three interfaces - Electron GUI, wdc CLI and REST API with Bearer-token auth
🤖 MCP server - 67 tools for Claude Code or any MCP client: sites, databases, services, SSL, plugins, backups, Cloudflare tunnels, deployments. Every tool call is logged and shown in the GUI's MCP → Activity tab (24h timeline, top tools, p50/p95/p99 latency, CSV export). See src/daemon/NKS.WebDevConsole.Daemon/Mcp/README.md for the operator guide.
☁️ Cloudflare - tunnels, DNS records and routes via cloudflared
🔐 Elevated on Windows - one UAC prompt at launch, no per-operation prompts for hosts-file edits
📦 Self-contained daemon - .NET 9 published with --self-contained, no separate runtime install needed
🧪 Type checking - strict TypeScript on the frontend, nullable enable on the backend, 595+ xUnit tests

Requirements

Running the pre-built app

Windows 10 / 11 (x64), administrator rights for hosts-file editing
macOS 14+ (Apple Silicon, arm64)
Linux: any glibc 2.28+ distribution (Ubuntu 22.04+, Debian 12+, Fedora 38+)

Building from source

Tool	Version	Notes
.NET SDK	9.0+	macOS: `brew install dotnet@9`
Node.js	20 LTS+	Tested with 22 (CI) and 23.x
Python	3.11+	Optional, only for running the catalog-api locally
Git	any

Installation

Pre-built releases

Download the latest installer from GitHub Releases:

Windows: NKS.WebDev.Console-<version>-setup-x64.exe (NSIS) or *-portable-x64.exe
macOS: NKS.WebDev.Console-<version>-mac-arm64.dmg or *.zip
Linux: NKS.WebDev.Console-<version>-linux-x86_64.AppImage

From source

git clone https://github.com/nks-hub/webdev-console.git
cd webdev-console

# 1. Build the .NET solution (daemon + plugin SDK + tests)
dotnet build WebDevConsole.sln -c Release

# 2. Install frontend dependencies (~150 MB Electron binary on first run)
cd src/frontend
npm install

# 3. Build the platform installer
npm run dist          # Windows (NSIS + portable)
npm run dist:mac      # macOS (DMG + ZIP)
npm run dist:linux    # Linux (AppImage)

Output lands in src/frontend/release/.

Quick Start

Start the daemon + Electron in development:

# Terminal 1 — daemon
dotnet run --project src/daemon/NKS.WebDevConsole.Daemon

# Terminal 2 — Electron with hot-reload
cd src/frontend && npm run dev

On Windows, run.cmd from the repo root does both (supports --no-build, --daemon-only, --frontend-only).

Create your first site:

wdc site create --name my-app --php 8.3 --domain my-app.local --ssl
wdc service start apache

Open https://my-app.local/. The site is served from ~/wdc/sites/my-app/ with PHP 8.3 through Apache + mod_fcgid and a mkcert-signed SSL certificate.

Usage

CLI

The wdc binary (System.CommandLine) is published alongside the daemon:

wdc site list                                 # list all sites
wdc site create --name my-app --php 8.3 \
                --domain my-app.local --ssl   # create + provision SSL
wdc service start apache
wdc database list
wdc binaries catalog                          # available PHP / Apache / MySQL versions
wdc doctor                                    # 13 health checks
wdc --json site list                          # machine-readable output for scripts

All write commands have HttpRequestException handling; list commands emit TSV when piped.

REST API + auth

The daemon writes its listening port + fresh Bearer token at startup:

OS	Port file
Windows	`%TEMP%\nks-wdc-daemon.port`
macOS	`$TMPDIR/nks-wdc-daemon.port`
Linux	`/tmp/nks-wdc-daemon.port`

Format: line 1 = port (e.g. 5000), line 2 = base64 token. The token rotates on every restart.

PORT=$(sed -n 1p $TMPDIR/nks-wdc-daemon.port)
TOKEN=$(sed -n 2p $TMPDIR/nks-wdc-daemon.port)
curl -H "Authorization: Bearer $TOKEN" http://localhost:$PORT/api/status
# → {"status":"running","version":"0.2.3","plugins":13,"uptime":215437}

OpenAPI spec is exposed at /openapi/v1.json.

MCP server (Claude Code)

cd services/mcp-server
npm install && npm run build
claude mcp add --scope user nks-wdc node "$(pwd)/dist/index.js"

Module	Tools	Examples
sites	6	list, get, create, delete, get_metrics, get_access_log
services	3	list, start, stop
system	3	status, system_info, recent_activity
databases	6	list, create, drop, tables, query, execute
ssl	4	list_certs, install_ca, generate_cert, revoke_cert
php	2	set_default, toggle_extension
binaries	5	list_catalog, list_installed, install, uninstall, refresh
plugins	5	list, get, enable, disable, info
backup	3	create, list, restore
settings	2	get, update
cloudflare	9	tunnels, dns, routes, …

Destructive tools (drop_database, delete_site, revoke_cert, restore_backup, execute) require confirm: "YES".

MAMP PRO migration

wdc migrate mamp --port 3308              # dry-run
wdc migrate mamp --port 3308 --apply      # migrate

Reads %APPDATA%\Appsolute\MAMPPRO\userdb\mamp.db and rebuilds sites + databases in WDC.

Architecture

webdev-console/
├── src/
│   ├── daemon/                              # C# .NET 9
│   │   ├── NKS.WebDevConsole.Daemon         # ASP.NET Core REST service
│   │   ├── NKS.WebDevConsole.Core           # shared services + models
│   │   ├── NKS.WebDevConsole.Cli            # `wdc` CLI (System.CommandLine)
│   │   └── NKS.WebDevConsole.Plugin.SDK     # plugin contract
│   └── frontend/                            # Electron 34 + Vue 3 + Element Plus + Tailwind v4
├── services/
│   ├── catalog-api/                         # FastAPI sidecar (binary + version catalog)
│   └── mcp-server/                          # TypeScript stdio MCP server (67 tools, Phase 8 audit log)
├── tests/                                   # xUnit tests (Daemon + Core)
├── scripts/                                 # build helpers
└── .github/workflows/                       # CI matrix — Windows, macOS, Linux

Related repositories

NKS WebDev Console ships as four co-operating public repositories:

Repo	Purpose
`nks-hub/webdev-console`	This repo: daemon, CLI, Electron frontend, Plugin SDK
`nks-hub/webdev-console-plugins`	13 official plugins (Apache, PHP, MySQL, …)
`nks-hub/webdev-console-binaries`	Versioned runtime binaries (PHP, Apache, Nginx, Caddy, …)
`nks-hub/wdc-catalog-api`	FastAPI catalog + config-sync service

A single v* tag push to this repo triggers Build & Release (Win/macOS/Linux installers), Publish Plugin SDK (GitHub Packages NuGet), Defender Submission and Release Security Scan in parallel.

Development

Tests

dotnet test WebDevConsole.sln                  # 595+ tests (daemon + core)
cd services/catalog-api && pytest              # FastAPI sidecar tests
cd services/mcp-server && node e2e-test.mjs    # MCP smoke tests (27 assertions)

Cutting a release

git tag v0.2.3
git push --tags

GitHub Actions builds all three platforms and uploads to Releases. macOS code-signing uses CSC_LINK + CSC_KEY_PASSWORD secrets when present; notarization requires APPLE_ID, APPLE_APP_SPECIFIC_PASSWORD, APPLE_TEAM_ID.

CI matrix

OS	Daemon RID	Output
`windows-2022`	`win-x64`	`-setup-x64.exe` (NSIS) + `-portable-x64.exe`
`macos-14`	`osx-arm64`	`-mac-arm64.dmg` + `-mac-arm64.zip`
`ubuntu-24.04`	`linux-x64`	`*.AppImage`

Contributing

Contributions are welcome! For major changes, please open an issue first. Keep dotnet test and the frontend build green; CI runs the matrix build for all three platforms.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'feat: description')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Support

📧 Email: dev@nks-hub.cz
🐛 Bug reports: GitHub Issues

License

MIT License — see LICENSE for details.

Made with ❤️ by NKS Hub

Navigation Menu

Repository navigation

About

Repository files navigation

NKS WebDev Console

Features

Requirements

Running the pre-built app

Building from source

Installation

Pre-built releases

From source

Quick Start

Usage

CLI

REST API + auth

MCP server (Claude Code)

MAMP PRO migration

Architecture

Related repositories

Development

Tests

Cutting a release

CI matrix

Contributing

Support

License

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
.github		.github
docs/plans		docs/plans
scripts		scripts
services		services
src		src
tests		tests
tools		tools
.gitignore		.gitignore
AGENTS.md		AGENTS.md
LICENSE		LICENSE
README.md		README.md
WebDevConsole.sln		WebDevConsole.sln
run.cmd		run.cmd
start-all.cmd		start-all.cmd
start-daemon.cmd		start-daemon.cmd
start-frontend.cmd		start-frontend.cmd
start.cmd		start.cmd

Latest commit

History

Folders and files

Repository files navigation

NKS WebDev Console

Features

Requirements

Running the pre-built app

Building from source

Installation

Pre-built releases

From source

Quick Start

Usage

CLI

REST API + auth

MCP server (Claude Code)

MAMP PRO migration

Architecture

Related repositories

Development

Tests

Cutting a release

CI matrix

Contributing

Support

License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages