easy-devops 0.2.1 → 0.2.3

package/README.md

@@ -21,6 +21,7 @@ A unified DevOps management tool with interactive CLI and web dashboard for mana
 
 - **Node.js 18+** (with npm)
 - **Linux** (Debian/Ubuntu) or **Windows**
+- ⚠️ **Windows users: PowerShell must be run as Administrator** (required for installing packages via winget, managing services, and SSL certificates)
 - Optional: Nginx, Certbot, nvm (installed separately or via the tool)
 
 ## Installation
@@ -49,6 +50,8 @@ wget -qO- https://raw.githubusercontent.com/omar00050/Easy-DevOps/main/install.s
 
 #### Windows (PowerShell)
 
+> ⚠️ **Important:** Run PowerShell **as Administrator**. Right-click PowerShell → "Run as Administrator".
+
 ```powershell
 Invoke-WebRequest -Uri "https://raw.githubusercontent.com/omar00050/Easy-DevOps/main/install.ps1" -OutFile "install.ps1"; ./install.ps1
 ```
@@ -175,6 +178,20 @@ Manage Let's Encrypt SSL certificates using Certbot.
 
 > **Note:** Renewing a certificate temporarily stops Nginx to free port 80, then restarts it automatically.
 
+#### Windows Package Manager (winget)
+
+Easy DevOps uses **winget** (Windows Package Manager) to install certbot and other packages on Windows. If winget is not installed, Easy DevOps will automatically prompt to install it using the [asheroto/winget-install](https://github.com/asheroto/winget-install) script.
+
+**Installing winget manually:**
+
+If you prefer to install winget separately, you can:
+
+1. **Install from Microsoft Store:** Search for "App Installer" in the Microsoft Store
+2. **Use the winget-install script:** [https://github.com/asheroto/winget-install](https://github.com/asheroto/winget-install)
+3. **Official Microsoft documentation:** [https://learn.microsoft.com/en-us/windows/package-manager/winget/](https://learn.microsoft.com/en-us/windows/package-manager/winget/)
+
+> **Note:** The embedded `winget-install.ps1` script in this project is sourced from [asheroto/winget-install](https://github.com/asheroto/winget-install) — a community-maintained, reliable installer for winget on Windows Server and systems without the Microsoft Store.
+
 ---
 
 ### Web Dashboard
@@ -187,7 +204,15 @@ Start the web dashboard:
 npm run dashboard
 ```
 
-Access at `http://localhost:3000` (or configured port).
+Access at `http://localhost:6443` (or configured port).
+
+#### First-Time Login
+
+Default credentials:
+- **Username:** `admin`
+- **Password:** Set in Settings menu or check your configuration
+
+> **Tip:** From the Dashboard menu, select "How to use" for a quick guide on getting started.
 
 #### Dashboard Pages
 
@@ -245,7 +270,8 @@ easy-devops/
 │   ├── config.js         # Configuration loader
 │   ├── db.js             # SQLite database (good.db)
 │   ├── detector.js       # System environment detection
-│   └── shell.js          # Cross-platform shell executor
+│   ├── shell.js          # Cross-platform shell executor
+│   └── nginx-conf-generator.js  # Nginx config file generator
 ├── dashboard/
 │   ├── server.js         # Express + Socket.io server
 │   ├── routes/           # API endpoints
@@ -255,7 +281,10 @@ easy-devops/
 ├── data/
 │   └── easy-devops.sqlite
 └── lib/
-    └── installer/        # Bootstrap scripts
+    └── installer/
+        ├── install.ps1   # Windows bootstrap installer
+        ├── install.sh    # Linux/macOS bootstrap installer
+        └── winget-install.ps1  # Windows Package Manager installer
 ```
 
 ---

package/cli/menus/dashboard.js

@@ -139,6 +139,26 @@ function openBrowser(url) {
   run(cmd).catch(() => {});
 }
 
+// ─── Usage Info ──────────────────────────────────────────────────────────────
+
+function showUsageInfo() {
+  console.log(chalk.cyan('\n How to use the Dashboard:'));
+  console.log(chalk.gray(' ─'.repeat(40)));
+  console.log('  1. Start the dashboard from this menu');
+  console.log('  2. Open it in your browser (or visit the URL shown)');
+  console.log('  3. Log in with the admin password from config');
+  console.log('  4. Use the dashboard to:');
+  console.log(chalk.gray('     • Manage domains → create nginx configs'));
+  console.log(chalk.gray('     • View SSL certificates'));
+  console.log(chalk.gray('     • Control nginx (start/stop/reload)'));
+  console.log(chalk.gray('     • Edit nginx configuration files'));
+  console.log();
+  console.log(chalk.yellow(' Default login:'));
+  console.log(chalk.gray('   Username: admin'));
+  console.log(chalk.gray('   Password: (check your config or set one)'));
+  console.log();
+}
+
 // ─── Menu ─────────────────────────────────────────────────────────────────────
 
 export default async function dashboardMenu() {
@@ -160,8 +180,8 @@ export default async function dashboardMenu() {
     console.log();
 
     const choices = status.running
-      ? ['Open in browser', 'Stop dashboard', new inquirer.Separator(), '← Back']
-      : ['Start dashboard', new inquirer.Separator(), '← Back'];
+      ? ['Open in browser', 'Stop dashboard', 'How to use', new inquirer.Separator(), '← Back']
+      : ['Start dashboard', 'How to use', new inquirer.Separator(), '← Back'];
 
     let choice;
     try {

package/cli/menus/update.js

@@ -4,31 +4,37 @@
  * Check for updates and upgrade easy-devops in place.
  *
  * Flow:
- *  1. Fetch latest version from npm registry
- *  2. If an update is available, offer to install it
- *  3. Before installing: record dashboard running state in DB
- *     (key: 'update-pre-dashboard') so it survives a crash mid-update
- *  4. Stop dashboard if it was running
- *  5. Run: npm install -g easy-devops@<latest>
- *  6. Re-start dashboard if it was running before
- *  7. Clear the saved state key
+ * 1. Fetch latest version from npm registry
+ * 2. If an update is available, offer to install it
+ * 3. Before installing: record dashboard running state in DB
+ *    (key: 'update-pre-dashboard') so it survives a crash mid-update
+ * 4. Stop dashboard if it was running
+ * 5. Close database connection
+ * 6. Spawn an external update script that runs npm install
+ *    after this process exits (to avoid EBUSY on Windows)
+ * 7. This process exits; update script runs
+ * 8. On next launch, recoverIfNeeded restarts dashboard if needed
  */
 
 import chalk from 'chalk';
 import inquirer from 'inquirer';
 import ora from 'ora';
 import path from 'path';
+import fs from 'fs';
 import { fileURLToPath } from 'url';
 import { createRequire } from 'module';
+import { spawn } from 'child_process';
 import { run } from '../../core/shell.js';
-import { dbGet, dbSet, closeDb, initDb } from '../../core/db.js';
+import { dbGet, dbSet, closeDb } from '../../core/db.js';
 import { loadConfig } from '../../core/config.js';
-import { getDashboardStatus, startDashboard, stopDashboard } from './dashboard.js';
+import { getDashboardStatus, stopDashboard } from './dashboard.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const require   = createRequire(import.meta.url);
+const require = createRequire(import.meta.url);
 const { version: currentVersion } = require('../../package.json');
 
+const isWindows = process.platform === 'win32';
+
 // ─── Version helpers ──────────────────────────────────────────────────────────
 
 async function fetchLatestVersion() {
@@ -54,18 +60,20 @@ async function recoverIfNeeded() {
   const saved = dbGet('update-pre-dashboard');
   if (!saved?.wasRunning) return;
 
-  console.log(chalk.yellow('\n  A previous update left the dashboard stopped.'));
+  console.log(chalk.yellow('\n A previous update left the dashboard stopped.'));
   const { restart } = await inquirer.prompt([{
-    type:    'confirm',
-    name:    'restart',
+    type: 'confirm',
+    name: 'restart',
     message: 'Restart the dashboard now?',
     default: true,
   }]);
 
   if (restart) {
+    // Dynamic import to avoid circular dependency and ensure fresh state
+    const { startDashboard } = await import('./dashboard.js');
     const port = saved.port || loadConfig().dashboardPort;
-    const sp   = ora(`Starting dashboard on port ${port}...`).start();
-    const res  = await startDashboard(port);
+    const sp = ora(`Starting dashboard on port ${port}...`).start();
+    const res = await startDashboard(port);
     res.success
       ? sp.succeed(`Dashboard restarted on port ${port}`)
       : sp.fail('Could not restart dashboard — use the Dashboard menu');
@@ -76,54 +84,141 @@ async function recoverIfNeeded() {
 
 // ─── Perform update ───────────────────────────────────────────────────────────
 
+/**
+ * Creates and spawns an external update script that runs after this process exits.
+ * This is necessary on Windows because better-sqlite3's native module stays locked
+ * as long as any Node.js process has the database open.
+ */
 async function performUpdate(latestVersion) {
   // Step 1 — snapshot dashboard state and persist it
   const status = await getDashboardStatus();
   dbSet('update-pre-dashboard', {
     wasRunning: status.running,
-    pid:        status.pid,
-    port:       status.port,
+    pid: status.pid,
+    port: status.port,
   });
 
-  // Step 2 — stop dashboard if running
+  // Step 2 — stop dashboard if running (it has its own DB connection)
   if (status.running) {
     const sp = ora('Stopping dashboard...').start();
     await stopDashboard(status.pid);
     sp.succeed('Dashboard stopped');
+    // Give the dashboard process a moment to fully terminate
+    await new Promise(r => setTimeout(r, 2000));
   }
 
-  // Step 3 — close the SQLite connection so npm can rename the db file (EBUSY on Windows)
+  // Step 3 — close this process's database connection
   closeDb();
 
-  // Step 4 — install new version
-  const sp = ora(`Installing easy-devops@${latestVersion}...`).start();
-  const result = await run(`npm install -g easy-devops@${latestVersion}`, { timeout: 120000 });
+  // Step 4 — create an external update script and spawn it
+  // The script will run npm install after this process exits
+  const updateScriptPS = `
+$ProgressPreference = 'SilentlyContinue'
+Write-Host ""
+Write-Host "Installing easy-devops@${latestVersion}..." -ForegroundColor Cyan
+Write-Host ""
+npm install -g easy-devops@${latestVersion}
+if ($LASTEXITCODE -eq 0) {
+  Write-Host ""
+  Write-Host "Successfully updated to v${latestVersion}" -ForegroundColor Green
+  Write-Host "Run 'easy-devops' to start the new version." -ForegroundColor Gray
+} else {
+  Write-Host ""
+  Write-Host "Update failed. Please try again or update manually:" -ForegroundColor Red
+  Write-Host "  npm install -g easy-devops@${latestVersion}" -ForegroundColor Yellow
+}
+Write-Host ""
+Write-Host "Press any key to close this window..." -ForegroundColor Gray
+$null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
+`;
 
-  if (!result.success) {
-    sp.fail('Update failed');
-    console.log(chalk.red('\n' + (result.stderr || result.stdout) + '\n'));
-    // Leave 'update-pre-dashboard' in DB so recovery runs on next launch
-    return false;
-  }
+  const updateScriptBash = `#!/bin/bash
+echo ""
+echo -e "\\033[36mInstalling easy-devops@${latestVersion}...\\033[0m"
+echo ""
+npm install -g easy-devops@${latestVersion}
+if [ $? -eq 0 ]; then
+  echo ""
+  echo -e "\\033[32mSuccessfully updated to v${latestVersion}\\033[0m"
+  echo -e "\\033[90mRun 'easy-devops' to start the new version.\\033[0m"
+else
+  echo ""
+  echo -e "\\033[31mUpdate failed. Please try again or update manually:\\033[0m"
+  echo -e "\\033[33m  npm install -g easy-devops@${latestVersion}\\033[0m"
+fi
+echo ""
+read -p "Press Enter to close this window..."
+`;
 
-  sp.succeed(`Updated to v${latestVersion}`);
+  console.log(chalk.cyan('\n Starting external update process...'));
+  console.log(chalk.gray(' A new window will open to complete the update.'));
+  console.log(chalk.gray(' This window will close after the update starts.\n'));
 
-  // Re-initialize the database connection after npm replaced the module
-  initDb();
+  if (isWindows) {
+    // Write script to temp file and run in new PowerShell window
+    const tempDir = process.env.TEMP || 'C:\\Windows\\Temp';
+    const tempScript = path.join(tempDir, 'easy-devops-update.ps1');
+    fs.writeFileSync(tempScript, updateScriptPS, 'utf8');
 
-  // Step 5 — restart dashboard if it was running before
-  const saved = dbGet('update-pre-dashboard');
-  dbSet('update-pre-dashboard', null);
+    // Run in a new window, this process will exit
+    spawn('powershell.exe', [
+      '-NoExit',
+      '-ExecutionPolicy', 'Bypass',
+      '-File', tempScript
+    ], {
+      detached: true,
+      stdio: 'ignore',
+      windowsHide: false
+    }).unref();
 
-  if (saved?.wasRunning) {
-    const port    = saved.port || loadConfig().dashboardPort;
-    const restSp  = ora(`Restarting dashboard on port ${port}...`).start();
-    const res     = await startDashboard(port);
-    res.success
-      ? restSp.succeed(`Dashboard restarted on port ${port}`)
-      : restSp.fail('Could not restart dashboard — use the Dashboard menu');
+    // Clean up hint
+    console.log(chalk.gray(` Update script: ${tempScript}`));
+  } else {
+    // On Linux/Mac, run in a new terminal window if possible
+    const tempScript = '/tmp/easy-devops-update.sh';
+    fs.writeFileSync(tempScript, updateScriptBash, 'utf8');
+    fs.chmodSync(tempScript, '755');
+
+    // Try common terminal emulators
+    const terminals = [
+      ['gnome-terminal', '--', 'bash', '-c', updateScriptBash],
+      ['xterm', '-e', 'bash', '-c', updateScriptBash],
+      ['konsole', '-e', 'bash', '-c', updateScriptBash],
+    ];
+    let launched = false;
+
+    for (const [cmd, ...args] of terminals) {
+      try {
+        spawn(cmd, args, {
+          detached: true,
+          stdio: 'ignore'
+        }).unref();
+        launched = true;
+        break;
+      } catch { /* try next */ }
+    }
+
+    if (!launched) {
+      // Fallback: just run npm directly in this terminal
+      console.log(chalk.yellow('\nRunning update in this window...'));
+      const result = await run(`npm install -g easy-devops@${latestVersion}`, { timeout: 120000 });
+      if (result.success) {
+        console.log(chalk.green(`\n Successfully updated to v${latestVersion}`));
+      } else {
+        console.log(chalk.red('\n Update failed:'));
+        console.log(result.stderr || result.stdout);
+      }
+      return result.success;
+    }
   }
 
+  // Give a moment for the external process to start
+  await new Promise(r => setTimeout(r, 1000));
+
+  console.log(chalk.green('\n Update process launched.'));
+  console.log(chalk.gray(' Complete the update in the new window, then run: easy-devops'));
+  console.log(chalk.gray(' If the dashboard was running, it will be restarted on next launch.\n'));
+
   return true;
 }
 
@@ -137,12 +232,12 @@ export default async function updateMenu() {
   const latestVersion = await fetchLatestVersion();
   spinner.stop();
 
-  console.log(chalk.bold('\n  Check for Updates'));
-  console.log(chalk.gray('  ' + '─'.repeat(40)));
-  console.log(`  Current version : ${chalk.cyan('v' + currentVersion)}`);
+  console.log(chalk.bold('\n Check for Updates'));
+  console.log(chalk.gray(' ' + '─'.repeat(40)));
+  console.log(` Current version : ${chalk.cyan('v' + currentVersion)}`);
 
   if (!latestVersion) {
-    console.log(chalk.yellow('  Could not reach npm registry. Check your internet connection.\n'));
+    console.log(chalk.yellow(' Could not reach npm registry. Check your internet connection.\n'));
     await inquirer.prompt([{ type: 'input', name: '_', message: 'Press Enter to go back...' }]);
     return;
   }
@@ -150,9 +245,9 @@ export default async function updateMenu() {
   const updateAvailable = isNewer(latestVersion, currentVersion);
 
   if (updateAvailable) {
-    console.log(`  Latest version  : ${chalk.green('v' + latestVersion)}  ${chalk.yellow('← update available')}\n`);
+    console.log(` Latest version : ${chalk.green('v' + latestVersion)} ${chalk.yellow('← update available')}\n`);
   } else {
-    console.log(`  Latest version  : ${chalk.green('v' + latestVersion)}  ${chalk.gray('✓ up to date')}\n`);
+    console.log(` Latest version : ${chalk.green('v' + latestVersion)} ${chalk.gray('✓ up to date')}\n`);
   }
 
   const choices = updateAvailable
@@ -162,8 +257,8 @@ export default async function updateMenu() {
   let choice;
   try {
     ({ choice } = await inquirer.prompt([{
-      type:    'list',
-      name:    'choice',
+      type: 'list',
+      name: 'choice',
       message: 'Select an option:',
       choices,
     }]));
@@ -173,12 +268,9 @@ export default async function updateMenu() {
   }
 
   if (choice === `Update to v${latestVersion}`) {
-    const success = await performUpdate(latestVersion);
-    if (success) {
-      console.log(chalk.gray('\n  Restart easy-devops to use the new version.\n'));
-    }
+    await performUpdate(latestVersion);
     try {
-      await inquirer.prompt([{ type: 'input', name: '_', message: 'Press Enter to continue...' }]);
+      await inquirer.prompt([{ type: 'input', name: '_', message: 'Press Enter to exit...' }]);
     } catch { /* ExitPromptError */ }
   }
 }

package/core/nginx-conf-generator.js

@@ -257,7 +257,8 @@ export function buildConf(domain, nginxDir, certbotDir) {
 
   // Logging
   if (advanced?.accessLog) {
-    mainBlock.push(`  access_log /var/log/nginx/${name}.access.log;`);
+    const logDir = isWindows ? `${nginxDir.replace(/\\/g, '/')}/logs` : '/var/log/nginx';
+    mainBlock.push(` access_log ${logDir}/${name}.access.log;`);
   }
 
   // ─── Location Block ─────────────────────────────────────────────────────────
@@ -301,10 +302,10 @@ export function buildConf(domain, nginxDir, certbotDir) {
       mainBlock.push(`  error_page 500 502 503 504 /50x.html;`);
     }
     if (security.custom404) {
-      mainBlock.push(`  location = /404.html { root /usr/share/nginx/html; internal; }`);
+      mainBlock.push(`  location = /404.html { root ${isWindows ? nginxDir.replace(/\\/g, '/') + '/html' : '/usr/share/nginx/html'}; internal; }`);
     }
     if (security.custom50x) {
-      mainBlock.push(`  location = /50x.html { root /usr/share/nginx/html; internal; }`);
+      mainBlock.push(`  location = /50x.html { root ${isWindows ? nginxDir.replace(/\\/g, '/') + '/html' : '/usr/share/nginx/html'}; internal; }`);
     }
   }
 

package/dashboard/lib/nginx-service.js

@@ -141,17 +141,26 @@ export async function start() {
     throw new NginxNotFoundError('nginx binary not found');
   }
 
-  // Test config before starting
+  // Ensure required directories exist on Windows
+  if (process.platform === 'win32') {
+    await fs.mkdir(path.join(nginxDir, 'logs'), { recursive: true });
+    await fs.mkdir(path.join(nginxDir, 'temp'), { recursive: true });
+  }
+
+  // Test config before starting with explicit config path on Windows
   await ensureNginxInclude(nginxDir);
-  const testResult = await run(`${nginxExe} -t`);
+  const testCmd = process.platform === 'win32'
+    ? `${nginxExe} -c "${path.join(nginxDir, 'conf', 'nginx.conf')}" -t`
+    : `${nginxExe} -t`;
+  const testResult = await run(testCmd);
   if (!testResult.success) {
     return { success: false, output: combineOutput(testResult) };
   }
 
-  // Start nginx
+  // Start nginx with explicit config path on Windows
   if (process.platform === 'win32') {
-    // On Windows, nginx runs in foreground so we need Start-Process
-    const startCmd = `Start-Process -FilePath "${path.join(nginxDir, 'nginx.exe')}" -WorkingDirectory "${nginxDir}" -WindowStyle Hidden`;
+    const confPath = path.join(nginxDir, 'conf', 'nginx.conf');
+    const startCmd = `Start-Process -FilePath "${path.join(nginxDir, 'nginx.exe')}" -ArgumentList '-c','"${confPath}"' -WorkingDirectory "${nginxDir}" -WindowStyle Hidden`;
     await run(startCmd, { timeout: 10000 });
   } else {
     const result = await run('nginx', { cwd: nginxDir, timeout: 15000 });
@@ -216,7 +225,11 @@ export async function test() {
   }
 
   await ensureNginxInclude(nginxDir);
-  const result = await run(`${nginxExe} -t`);
+  // Use explicit -c flag on Windows to avoid path issues
+  const testCmd = process.platform === 'win32'
+    ? `${nginxExe} -c "${path.join(nginxDir, 'conf', 'nginx.conf')}" -t`
+    : `${nginxExe} -t`;
+  const result = await run(testCmd);
   return { success: result.success, output: combineOutput(result) };
 }
 

package/dashboard/routes/domains.js

@@ -18,7 +18,12 @@ function getNginxExe(nginxDir) {
 
 function nginxTestCmd(nginxDir) {
   const exe = getNginxExe(nginxDir);
-  return isWindows ? `& "${exe}" -t` : 'nginx -t';
+  // Use explicit -c flag on Windows to avoid path issues
+  if (isWindows) {
+    const confPath = `${nginxDir}\\conf\\nginx.conf`;
+    return `& "${exe}" -c "${confPath}" -t`;
+  }
+  return 'nginx -t';
 }
 
 function nginxReloadCmd(nginxDir) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easy-devops",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "A unified DevOps management tool with CLI and web dashboard for managing Nginx, SSL certificates, and Node.js on Linux and Windows servers.",
   "keywords": [
     "devops",