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
════════════════════════════════════════════════════════════════