Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
fix: recommend npm start for fresh production installs (#10948)
Adam Eivy00ef4427e658
diff --git a/README.md b/README.mdindex 38ac1fc135..79242ccfd2 100644--- a/README.md+++ b/README.md@@ -332,7 +332,7 @@ After that, `https://<machine>.<tailnet>.ts.net:5555` is the user-facing URL onThe same walkthrough is always available in **Settings → Setup**. It verifies one runnable AI provider as well as secure remote access, and links directly to every action PortOS cannot perform at the account level. The Dashboard and Instances page surface the same network state; Unix and Windows update scripts retry certificate provisioning and print the guide after every update. See the [complete setup guide](./docs/SETUP.md).-PM2 keeps PortOS running in the background. To configure startup after a reboot, run `npm run pm2:startup` from the repository root and follow the platform-specific instructions it prints, then run `npm run pm2:save` to save the process list. `npm start`, `npm run pm2:start`, and `npm run pm2:restart` save the selected app set, but do not install the startup service.+PM2 keeps PortOS running in the background. To configure startup after a reboot, run `npm run pm2:startup` from the repository root and follow the platform-specific instructions it prints, then run `npm run pm2:save` to save the process list. `npm start`, `npm run pm2:start`, and `npm run pm2:restart` save the selected app set, but do not install the startup service. `npm start` is the production entry point: it builds the client first. `npm run pm2:start` and `npm run pm2:restart` only manage the PM2 processes, so they require an already-built client (`client/dist`) and a prepared database; on a fresh checkout run `npm start` once instead.### Development Modediff --git a/scripts/pm2-startup-contract.test.js b/scripts/pm2-startup-contract.test.jsindex e0e7baec41..bda16f9288 100644--- a/scripts/pm2-startup-contract.test.js+++ b/scripts/pm2-startup-contract.test.js@@ -42,6 +42,18 @@ describe('PM2 startup app sets', () => {}});+ it('directs fresh production installs to the build-producing npm start command', () => {+ const setupSh = read('setup.sh');+ const setupPs1 = read('setup.ps1');+ const shellProduction = setupSh.match(/echo "\s*Production:\s+([^"]+)"/)?.[1];+ const psProduction = setupPs1.match(/Write-Host "\s*Production:\s+"[^;]*;\s*Write-Host "([^"]+)"/)?.[1];++ expect(shellProduction).toBe('npm start');+ expect(psProduction).toBe('npm start');+ expect(setupSh).not.toContain('pm2:start');+ expect(setupPs1).not.toContain('pm2:start');+ });+it('uses only production apps in both update scripts and their recovery starts', () => {const expectedApps = productionApps.join(',');const updateSh = read('update.sh');diff --git a/setup.ps1 b/setup.ps1index d0cfbfd21c..6dd699b71e 100644--- a/setup.ps1+++ b/setup.ps1@@ -121,7 +121,7 @@ Write-Host "===================================" -ForegroundColor GreenWrite-Host ""Write-Host "Start PortOS:"Write-Host " Development: " -NoNewline; Write-Host "npm run dev" -ForegroundColor Cyan-Write-Host " Production: " -NoNewline; Write-Host "npm start" -ForegroundColor Cyan; Write-Host " (or npm run pm2:start)" -NoNewline -ForegroundColor Gray; Write-Host ""+Write-Host " Production: " -NoNewline; Write-Host "npm start" -ForegroundColor CyanWrite-Host " Stop: " -NoNewline; Write-Host "npm run pm2:stop" -ForegroundColor CyanWrite-Host " Logs: " -NoNewline; Write-Host "npm run pm2:logs" -ForegroundColor CyanWrite-Host ""diff --git a/setup.sh b/setup.shindex 15f472e0a4..4b81aee1ad 100755--- a/setup.sh+++ b/setup.sh@@ -213,7 +213,7 @@ elseecho ""echo "Start PortOS:"echo " Development: npm run dev"- echo " Production: npm start (or npm run pm2:start)"+ echo " Production: npm start"echo " Stop: npm run pm2:stop"echo " Logs: npm run pm2:logs"echo ""