Skip to content

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