release: v0.18.7 — dedicated evonexus user + systemd service on VPS setup

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: DavidsonGomes

CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.18.7] - 2026-04-12
+
+### Added
+
+- **Dedicated `evonexus` user + systemd service** — VPS setup (`is_remote=True` as root) now automatically creates a dedicated system user, installs uv + Claude Code for it, and configures a systemd service (`evo-nexus`) that auto-starts on boot. Solves the Claude Code restriction that blocks `--dangerously-skip-permissions` as root
+- **`install-service.sh`** — standalone script to install the systemd service on existing installations (`sudo bash install-service.sh`). Safe to re-run
+- **CLI update mode uses systemd** — `npx @evoapi/evo-nexus .` now detects the systemd service and uses `systemctl restart` instead of calling `start-services.sh` directly. Syncs files to the service directory when they differ
+
+### Fixed
+
+- **systemd service type** — uses `Type=oneshot` with `RemainAfterExit=yes` since `start-services.sh` launches background processes with `nohup`
+
 ## [0.18.6] - 2026-04-12
 
 ### Fixed

cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evoapi/evo-nexus",
-  "version": "0.18.6",
+  "version": "0.18.7",
   "description": "Unofficial open source toolkit for Claude Code — AI-powered business operating system",
   "keywords": [
     "claude-code",

docs/getting-started.md

@@ -72,6 +72,23 @@ At minimum, you need:
 
 ### 4. Start the Dashboard
 
+**On a VPS (remote):** The setup wizard automatically creates a dedicated `evonexus` system user (Claude Code refuses `--dangerously-skip-permissions` as root) and installs a **systemd service** that starts on boot:
+
+```bash
+systemctl status evo-nexus      # check status
+systemctl restart evo-nexus     # restart
+journalctl -u evo-nexus -f      # follow logs
+su - evonexus                   # switch to service user
+```
+
+You can also install the systemd service manually on an existing installation:
+
+```bash
+sudo bash install-service.sh
+```
+
+**Local (macOS/Linux):**
+
 ```bash
 make dashboard-app
 ```
@@ -82,6 +99,8 @@ Open http://localhost:8080 — the first run shows a setup wizard where you crea
 
 ### 5. Start Automated Routines
 
+On a VPS, the scheduler runs automatically inside the dashboard service. Locally:
+
 ```bash
 make scheduler
 ```

docs/llms-full.txt

@@ -2281,6 +2281,23 @@ At minimum, you need:
 
 ### 4. Start the Dashboard
 
+**On a VPS (remote):** The setup wizard automatically creates a dedicated `evonexus` system user (Claude Code refuses `--dangerously-skip-permissions` as root) and installs a **systemd service** that starts on boot:
+
+```bash
+systemctl status evo-nexus      # check status
+systemctl restart evo-nexus     # restart
+journalctl -u evo-nexus -f      # follow logs
+su - evonexus                   # switch to service user
+```
+
+You can also install the systemd service manually on an existing installation:
+
+```bash
+sudo bash install-service.sh
+```
+
+**Local (macOS/Linux):**
+
 ```bash
 make dashboard-app
 ```
@@ -2291,6 +2308,8 @@ Open http://localhost:8080 — the first run shows a setup wizard where you crea
 
 ### 5. Start Automated Routines
 
+On a VPS, the scheduler runs automatically inside the dashboard service. Locally:
+
 ```bash
 make scheduler
 ```

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "evo-nexus"
-version = "0.18.6"
+version = "0.18.7"
 description = "Unofficial open source toolkit for Claude Code — AI-powered business operating system"
 requires-python = ">=3.10"
 dependencies = [