════════════════════════════════════════════════════════════════ Simple Asset Tracker — Windows Server Installation Guide ════════════════════════════════════════════════════════════════ DOWNLOAD ──────────────────────────────────────────────────────────────── Latest version: https://downloads.simpleassettracker.com/latest/SAT-Server-Package.zip All packages and installation guides: https://simpleassettracker.com/install/ Optional — check the download is complete and unmodified: Get-FileHash .\SAT-Server-Package.zip -Algorithm SHA256 (PowerShell) The result must match the line for SAT-Server-Package.zip in https://downloads.simpleassettracker.com/latest/SHA256SUMS.txt USE THIS GUIDE WHEN: • You are installing on Windows Server (2016, 2019, 2022 or 2025) • The machine has no graphical desktop (Server Core) • You are deploying remotely via RDP, SSH, or automation • SAT-Setup.exe showed a blank screen or crashed on your machine If your Windows machine has a normal graphical desktop, use SAT-Setup.exe and follow How to INSTALL-Windows.txt instead — it is easier. WHAT'S IN THIS PACKAGE ──────────────────────────────────────────────────────────────── install.ps1 PowerShell installer script app-source.tar Bundled application node-v20.18.3-x64.msi Bundled Node.js installer How to INSTALL-Windows-Server.txt This file All four files must remain in the same folder. SYSTEM REQUIREMENTS ──────────────────────────────────────────────────────────────── • Windows Server 2016, 2019, or 2022 — or — Windows 10 / 11 (64-bit, headless / no display) • 2 GB RAM minimum (4 GB recommended) • 3 GB free disk space on the install drive • 1 GB free disk space on C:\Windows\Temp • No internet connection required — all components are bundled • Administrator privileges (PowerShell run as Administrator) INSTALL PATH RULES (important): • Maximum path length: 100 characters Good: C:\SAT or D:\SimpleAssetTracker Bad: C:\Users\Admin\AppData\Local\Programs\Company\SimpleAssetTracker • No UNC / network paths (\\server\share) — use a local drive only • Paths with spaces and special characters are supported PORT RULES: • Use ports 1024–65535 (ports below 1024 are reserved by Windows) • Frontend and backend ports must be different • Leave at least 3 numbers between them (e.g. 3000 and 4000) (the launcher also reserves frontendPort+1 and frontendPort+2 internally) • Default: frontend 3000, backend 4000 INSTALLATION STEPS ──────────────────────────────────────────────────────────────── Step 1 — Extract SAT-Server-Package.zip Copy SAT-Server-Package.zip to the server and extract it. With a desktop (Explorer): Right-click SAT-Server-Package.zip → "Extract All" From PowerShell (Server Core / no desktop): Expand-Archive -Path "C:\path\to\SAT-Server-Package.zip" -DestinationPath "C:\SAT-Install" cd C:\SAT-Install You will get: install.ps1 app-source.tar node-v20.18.3-x64.msi How to INSTALL-Windows-Server.txt Step 2 — Open PowerShell as Administrator Method A (GUI): Start → search "PowerShell" → right-click → "Run as administrator" Method B (keyboard shortcut): Press Win + X → select "Windows PowerShell (Admin)" Method C (Server Core / no desktop): On true Server Core your session is already running as Administrator — no elevation dialog is needed. Simply launch PowerShell directly: At the command prompt, type: powershell If you do need to elevate (e.g. you are logged in as a non-admin): powershell -Command "Start-Process powershell -Verb RunAs" Note: -Verb RunAs shows a UAC dialog, which requires a desktop session. Step 3 — Allow script execution for this session Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass Step 4 — Navigate to the extracted folder cd "C:\Users\YourName\Downloads\SAT-Server-Package" (replace the path with wherever you extracted the files) Step 5 — Run the installer Default install (C:\SimpleAssetTracker, ports 3000 / 4000): .\install.ps1 Custom install location and/or ports: .\install.ps1 -InstallDir "D:\SAT" -FrontendPort 8080 -BackendPort 8081 The installer will automatically: ✓ Install Node.js 20 LTS from the bundled MSI ✓ Extract and configure the application ✓ Set up the database ✓ Build the web interface (if not pre-built) ✓ Start the application via PM2 ✓ Register an auto-start task (runs at boot, no login required) This takes approximately 5–10 minutes. Do not close the PowerShell window while it is running. Step 6 — Installation complete When you see "Simple Asset Tracker is running!" the app is ready. To access it from the server itself: https://localhost:3000 To access it from another machine on the network: https://:3000 ACCESSING THE APPLICATION ──────────────────────────────────────────────────────────────── Open a browser and go to: https://:3000 (from another machine) https://localhost:3000 (from the server itself) ⚠ IMPORTANT — Certificate Warning Your browser will show a security warning because the app uses a self-signed HTTPS certificate. This is normal. To proceed: Chrome / Edge: Click "Advanced" → "Proceed to localhost (unsafe)" Firefox: Click "Advanced" → "Accept the Risk and Continue" Safari: Click "Visit Website" FIREWALL — the installer opens the port for you Setup adds a Windows Firewall rule named "Simple Asset Tracker" that lets phones and computers on the SAME local network reach the app (never the internet). If another device still cannot connect: • It must be on the same network (office Wi-Fi / LAN), not mobile data. • Check the rule exists (PowerShell as Administrator): Get-NetFirewallRule -DisplayName "Simple Asset Tracker" • A company firewall, antivirus firewall or VPN may also block it. FIRST LOGIN ──────────────────────────────────────────────────────────────── Username: simpleadmin Password: simpleadmin@123 ⚠ Change this password immediately after your first login. Go to: Settings → Users → simpleadmin → Set Password MANAGING THE APPLICATION ──────────────────────────────────────────────────────────────── The application runs as a background service via PM2. It starts automatically at every system boot — even with no user logged in (registered as a Windows Task Scheduler ONSTART task). To manage it, open PowerShell as Administrator and run: (default install path shown — substitute yours if you used -InstallDir) $env:PM2_HOME = 'C:\ProgramData\SimpleAssetTracker\pm2' $pm2 = "C:\SimpleAssetTracker\simple-asset-tracker\vendor\node_modules\pm2\bin\pm2" Check status: node $pm2 status View logs: node $pm2 logs simple-asset-tracker Stop: node $pm2 stop simple-asset-tracker Restart: node $pm2 restart simple-asset-tracker Start: node $pm2 start simple-asset-tracker To check that the auto-start task is registered: schtasks /Query /TN "SimpleAssetTracker-PM2" UNINSTALLING ──────────────────────────────────────────────────────────────── BACKUP YOUR DATA FIRST ───────────────────────────────────────────────────────────── All application data lives in one folder: C:\SimpleAssetTracker\simple-asset-tracker\backend\data\ (substitute your install directory if you used -InstallDir) This folder contains: • simple-asset-tracker.db — your SQLite database (all assets, users, audit logs, verification history) • app-config.json — your port and organisation settings Option A — Use the built-in backup feature (recommended): Log in → Settings → Backup → Create Backup This downloads a .zip of the database to your Downloads folder. Option B — Copy the folder manually (PowerShell): Copy-Item -Recurse ` "C:\SimpleAssetTracker\simple-asset-tracker\backend\data" ` "C:\SAT-Backup-$(Get-Date -Format 'yyyyMMdd')" To restore after a reinstall: copy the backed-up data\ folder back into the same path inside the new install before starting the application. Also keep a copy of simple-asset-tracker\backend\.env — the saved SAP / Oracle / Zoho passwords are encrypted with a key stored in it. Copy it back over the new install's backend\.env when restoring; without it, re-enter the ERP credentials under Integrations. (Upgrading by re-running the installer keeps all of this automatically.) ───────────────────────────────────────────────────────────── 1. Open PowerShell as Administrator and stop the service: $env:PM2_HOME = 'C:\ProgramData\SimpleAssetTracker\pm2' $pm2 = "C:\SimpleAssetTracker\simple-asset-tracker\vendor\node_modules\pm2\bin\pm2" node $pm2 stop simple-asset-tracker node $pm2 delete simple-asset-tracker node $pm2 save --force node $pm2 kill 2. Remove the auto-start task: schtasks /Delete /TN "SimpleAssetTracker-PM2" /F 3. Delete the install folder: Remove-Item -Recurse -Force "C:\SimpleAssetTracker" (replace with your chosen install directory) 4. Remove the firewall rule the installer added: Remove-NetFirewallRule -DisplayName "Simple Asset Tracker" 5. Remove the PM2 service data: Remove-Item -Recurse -Force "C:\ProgramData\SimpleAssetTracker" 6. Optionally remove Node.js: Windows Settings → Apps → Node.js → Uninstall — or — msiexec /x node-v20.18.3-x64.msi /quiet FORCE RESTART / PARTIAL LAUNCH ──────────────────────────────────────────────────────────────── The application runs three internal services under a single PM2 process (start.js): a proxy, the frontend, and the backend. PM2 may show "online" even when one or more of those services has crashed internally. How to tell if a service is down Open PowerShell as Administrator and run: $env:PM2_HOME = 'C:\ProgramData\SimpleAssetTracker\pm2' $pm2 = "C:\SimpleAssetTracker\simple-asset-tracker\vendor\node_modules\pm2\bin\pm2" node $pm2 logs simple-asset-tracker --lines 100 Look for lines like: [launcher] x backend is crash-looping - giving up [launcher] x frontend is crash-looping - giving up [launcher] x proxy is crash-looping - giving up Substitute the path if you used -InstallDir during install. Browser shows "connection refused" but PM2 shows "online" The mux proxy (port 3000) may have failed to bind while the frontend is still running on its internal port. Try: https://localhost:3001 (Replace 3001 with your frontendPort + 1 if you used a custom port.) If that loads, only the proxy is down — a restart fixes it. Force restart (restarts all three services — safe, no data loss) Open PowerShell as Administrator and run: $env:PM2_HOME = 'C:\ProgramData\SimpleAssetTracker\pm2' $pm2 = "C:\SimpleAssetTracker\simple-asset-tracker\vendor\node_modules\pm2\bin\pm2" node $pm2 restart simple-asset-tracker Substitute the path above if you used -InstallDir. Restart from the browser (if the frontend is still reachable) Go to Settings and use the Restart button. This triggers a clean stop-and-start of all internal services without touching your data or configuration. If PM2 itself is unresponsive (process not running at all) Open PowerShell as Administrator and run: $env:PM2_HOME = 'C:\ProgramData\SimpleAssetTracker\pm2' $pm2 = "C:\SimpleAssetTracker\simple-asset-tracker\vendor\node_modules\pm2\bin\pm2" Set-Location "C:\SimpleAssetTracker\simple-asset-tracker" node $pm2 start start.js --name simple-asset-tracker Decision tree App unreachable? node $pm2 status shows "errored" or "stopped" -> node $pm2 restart simple-asset-tracker Status shows "online" but browser fails -> Try https://:3001 Loads -> proxy port conflict -> restart Fails -> check logs for crash-loop messages backend crash-looping -> check .env, port 4000 frontend crash-looping -> check certs, port 3001 Nothing helps -> node $pm2 stop simple-asset-tracker node $pm2 start simple-asset-tracker TROUBLESHOOTING ──────────────────────────────────────────────────────────────── "Install path is too long" error → Choose a shorter install path (e.g. C:\SAT or D:\SAT). → Paths over 100 characters cause failures deep in node_modules. "UNC/network paths are not supported" error → The install path must be on a local drive (C:\, D:\, etc.). → Network drives (\\server\share) are not supported — SQLite and PM2 do not work reliably over network file systems. "Ports below 1024" or "ports are adjacent" error → Choose ports between 1024 and 65535. → Frontend and backend must be different and at least 2 apart. App won't open in browser (from another machine) → See FIREWALL in ACCESSING THE APPLICATION (install.ps1 adds the rule). → Confirm the service is running: node $pm2 status → Check logs: node $pm2 logs simple-asset-tracker App does not start after server reboot (no one logged in) → The installer registers an ONSTART Task Scheduler entry, which fires at boot without requiring a user to log in. → If it still does not start, check the task exists: schtasks /Query /TN "SimpleAssetTracker-PM2" → Re-run install.ps1 to re-register it. nvm-windows warning during install → nvm may reactivate an older Node.js version after reboot. → Open an admin terminal and run: nvm use 20.18.3 → Then restart the SAT service. Installer fails midway → Re-run install.ps1 — it resumes safely and preserves your data. If an UPGRADE fails part-way, the previous version is put back and restarted automatically. Upgrading to a new version → Extract the new SAT-Server-Package.zip and run its install.ps1 with the same -InstallDir as before (default C:\SimpleAssetTracker). The application files are replaced; your data, settings, saved ERP connections, sign-ins and HTTPS certificate are kept. → If you need to delete the install folder and start fresh: First back up: C:\SimpleAssetTracker\simple-asset-tracker\backend\data\ Then delete the folder and re-run install.ps1. Port already in use → install.ps1 only stops earlier Simple Asset Tracker processes. If another program holds a port, it stops, names that program and leaves it running. Stop that program, or re-run on other ports: .\install.ps1 -FrontendPort 3100 -BackendPort 4100 Forgot the master admin password → Open: https://localhost:3000/reset-master-password → Enter your application license key and set a new password. Need help? → Contact your software vendor for support. ════════════════════════════════════════════════════════════════ Simple Asset Tracker — simpleassettracker.com ════════════════════════════════════════════════════════════════