Skip to content

nself cli v0.4.0

Choose a tag to compare

View all tags
@acamarata acamarata released this 13 Oct 21:03
v0.4.0
e5d6d12

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

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.

Assets 2
Loading
0 Join discussion