← All downloads

Installation guide

Install on Windows Server

Windows Server without a desktop (Server Core), remote or scripted installs. PowerShell installer.

════════════════════════════════════════════════════════════════
  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://<server-ip-address>:3000


ACCESSING THE APPLICATION
────────────────────────────────────────────────────────────────

  Open a browser and go to:

      https://<server-ip>: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://<server-ip>: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
════════════════════════════════════════════════════════════════