nself cli v0.4.0

[acamarata]

nself v0.4.0 — Production-Ready Release

Status: ✅ Stable Production Release
Date: 2025-10-13
View on GitHub →

---

Overview

v0.4.0 marks the production-ready milestone for nself, focused on stability, cross-platform compatibility, and complete reliability across macOS, Linux, and WSL.
Every core feature and service has been tested end-to-end for real-world usage.

What “Production-Ready” Means

• ✅ Fully Functional Core — All essential commands validated
• ✅ Cross-Platform — Works on Bash 3.2+ (macOS default) and newer
• ✅ Thoroughly Tested — 12 / 12 CI tests passing across all platforms
• ✅ Well Documented — Clear installation and usage guides
• ✅ Stable Foundation — Solid base for all future 0.4.x enhancements

---

Core Features

Infrastructure Services

• PostgreSQL — Production-grade DB with 60+ extensions
• Hasura GraphQL — Real-time API with subscriptions
• Auth Service — JWT-based nHost authentication
• Nginx — Reverse proxy + SSL termination

Optional Services

Enable on demand via environment flags:

• Redis — Cache/session store
• MinIO — S3-compatible object storage
• nself-admin — Web UI (port 3100)
• MailPit — Email testing server
• MeiliSearch — Fast search engine
• Functions — Serverless runtime
• MLflow — ML experiment tracking

Monitoring Bundle (10 Services)

Activate with MONITORING_ENABLED=true:

Prometheus, Grafana, Loki, Promtail, Tempo, Alertmanager, cAdvisor, Node Exporter, Postgres Exporter, Redis Exporter

---

CLI Commands

Core Operations: init, build, start, stop, restart, reset, clean, restore
Status / Monitoring: status, logs, exec, urls, doctor
Management: ssl, trust, admin, version, update, help

---

Service Templates (40 +)

Pre-built templates for instant service creation:

• JavaScript / TypeScript (19): Node.js, Express, Fastify, NestJS, Hono, Socket.IO, BullMQ, Temporal, Bun, Deno, tRPC, etc.
• Python (7): Flask, FastAPI, Django REST, Celery, Ray, AI Agents
• Go (4): Gin, Echo, Fiber, gRPC
• Other (10): Rust, Java, C#, C++, Ruby, Elixir, PHP, Kotlin, Swift

---

What’s New in v0.4.0

🐞 Fixed

Critical Bug #1 — Unbound Variables

• Fixed MONITORING_ENABLED and 13 service flags
• Added default fallbacks ${VAR:-default}
• Prevented first-build errors

Critical Bug #2 — Bash 4+ Incompatibilities

• Replaced ${var^^} with tr '[:lower:]' '[:upper:]'
• Fixed 3 instances across codebase
• Now fully compatible with macOS Bash 3.2

⚙️ Enhanced

• Full Bash 3.2+ support (macOS default)
• 12/12 CI pipelines green across platforms
• Updated all docs, examples, and version refs
• Marked stable for production environments

---

Installation

Quick Install

curl -sSL https://install.nself.org | bash

Custom Install

# Specific version
NSELF_VERSION=v0.4.0 curl -sSL https://install.nself.org | bash

# Custom directory
NSELF_INSTALL_DIR=/opt/nself curl -sSL https://install.nself.org | bash

---

Migration from v0.3.9

Breaking Changes: None — full backward compatibility.

Recommended Steps:

nself update
nself version   # should show v0.4.0
cd your-project
nself build && nself start
nself status && nself doctor

---

Roadmap — v0.4.x Series

Version	Focus Area	Highlights
v0.4.1	Service Management	Email / Search / Functions / MLflow commands
v0.4.2	Monitoring	Metrics + Dashboard management
v0.4.3	Database	nself db operations
v0.4.4	Backup & Restore	backup, rollback
v0.4.5	Production Tools	prod, deploy commands
v0.4.6	Scaling	scale operations

See ROADMAP.md for details.

---

System Requirements

Requirement	Minimum
OS	macOS / Linux / WSL
Bash	3.2 +
Docker	20.10 +
Docker Compose	2.0 +
Memory	2 GB +
Disk	5 GB +

Tested Platforms:
✅ macOS 14 (Bash 3.2.57) ✅ Ubuntu 20.04+ ✅ Debian 11+ ✅ WSL2 ✅ RHEL/CentOS 8+

---

Support & Community

• 📘 Documentation (Wiki)
• 🧭 Issues
• 💬 Discussions
• 🔔 Releases

---

Acknowledgements

Thanks to everyone who tested, reported bugs, and helped shape nself v0.4.0 — your feedback directly built this stable foundation for the 0.4.x series and beyond.

---

This discussion was created from the release nself cli v0.4.0.