easy-devops 0.2.1 → 0.2.2

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/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.2",
   "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",