v0.2.3.
Complete release notes · 2026-08-19. Read upgrade instructions and runtime limits before deploying.
Added
- Monorepo Version Synchronization (
pnpm version:bump): Automated version bumper script synchronizing root, all 9 packages, and in-code API/CLI/MCP constants in a single step. - Traefik Background Self-Healing Watchdog: Periodic watchdog reviving stopped or pruned proxy containers automatically.
- Automated Memory & Swap Provisioning:
install.sh automatically detects low-memory VPS hosts ($\le 4\text{GB}$ RAM) and allocates an active 2GB /swapfile to prevent OOM kills on heavy image pulls. - Enhanced Doctor & Self-Healing Engine:
ninedeploy doctor --fix with comprehensive RAM, Swap, Docker storage layer, SQLite integrity, network latency diagnostics, and automated repair. - Zero-Failure Ubuntu Server Hardening: Automatic installation of essential base utilities (
curl, git, ca-certificates, tar), pre-creation of the ninedeploy Docker network, pre-pulling of traefik:3, and conflict resolution for ports 80/443 (auto-disabling competing apache2/nginx services).
Fixed
- ACME Permissions Enforcement: Ensured strict
0600 permissions on /etc/traefik/acme.json before container mount. - Systemd Watchdog Timeout Termination: Switched systemd unit to
Type=simple and removed 90s watchdog timer to eliminate false-positive SIGTERM kills (exit code 143) during long builds and large image pulls (e.g. n8nio/n8n). - Database Migrator Directory Creation:
packages/db automatically ensures parent directories exist recursively to prevent SQLite Error 14 (SQLITE_CANTOPEN). - Cross-Platform MCP URL Resolution: Replaced manual string concatenation in
@ninedeploy/mcp with node:url pathToFileURL to normalize file URL comparisons across Windows drive letters and Linux paths. - Installer Script Health Loop: Fixed Bash special loop variable shadowing (
$_ in seq loop) during /health readiness polling in install.sh. - First-Run Admin Bootstrap: Hardened transactional setup and error handling for initial instance registration and database reset workflows.
Verified
- Monorepo Test Suite: Verified 100% test pass rate across 2,100+ tests and 100% branch/statement coverage in all 9 packages.
- Zero-Error Pipeline: Complete workspace verification across Biome linter, TypeScript strict typecheck, and production builds.
Source CHANGELOG.md at 6046cfe8