Complete guide for installing and managing ScaleCmdBridge on Windows systems.
- OS: Windows 10/11 (64-bit)
- RAM: Minimum 512 MB
- Disk Space: ~50 MB for application + logs
- Network: TCP port (default 8080) available
- Permissions: Administrator rights for installation
- Windows Service Manager (built-in)
- PowerShell 5.1+ (built-in)
- .NET Framework (usually pre-installed)
No additional runtime dependencies required - all dependencies are bundled.
-
Download
ScaleCmdBridge-Setup-x64.exefrom releases -
Right-click → Run as Administrator
-
Follow the installation wizard:
- Accept license agreement
- Choose installation directory (default:
C:\Program Files\ScaleCmdBridge) - Select port number (default: 8080)
- Choose optional components:
- Desktop shortcut
- Start Menu shortcuts
- Click Install
-
Installation completes automatically:
- Files copied to Program Files
- Windows Service installed
- Service started automatically
- Firewall rule created
-
Verify installation:
# Check service status sc query ScaleCmdBridge # Check web UI Start-Process "http://localhost:8080"
For advanced users or custom deployments:
# 1. Extract files to installation directory
$installDir = "C:\Program Files\ScaleCmdBridge"
New-Item -ItemType Directory -Path $installDir -Force
# 2. Copy files
# - ScaleCmdBridge.exe
# - nssm.exe
# - web\ directory
# - Service scripts
# 3. Install service
cd $installDir
.\INSTALL-SERVICE.bat
# 4. Configure firewall
netsh advfirewall firewall add rule name="ScaleCmdBridge" dir=in action=allow protocol=TCP localport=8080C:\ProgramData\ScaleCmdBridge\config\devices.json
The installer creates a default empty configuration. Add devices through the web UI:
- Open
http://localhost:8080in your browser - Navigate to Device Configuration
- Click Add New Device
- Fill in device details:
- Device ID (unique identifier)
- Name, Manufacturer, Model
- Protocol (RINCMD, DINICMD, etc.)
- Connection type (TCP or Serial)
- Connection parameters (host/port or COM port/baud rate)
- Commands (readGross, readNet, tare, zero)
- Click Save
{
"devices": {
"device_id": {
"name": "Device Name",
"manufacturer": "Manufacturer",
"model": "Model",
"protocol": "RINCMD",
"connection": {
"connection_type": "Tcp",
"host": "192.168.1.254",
"port": 4001,
"timeout_ms": 3000
},
"commands": {
"readGross": "20050026",
"readNet": "20050025",
"tare": "21120008:0C",
"zero": "21120008:0B"
},
"enabled": true
}
}
}Service environment variables (configured via NSSM):
CONFIG_PATH: Path to devices.json (default:C:\ProgramData\ScaleCmdBridge\config\devices.json)WEB_PATH: Path to web files (default:C:\Program Files\ScaleCmdBridge\web)PORT: Server port (default: 8080)
To modify:
cd "C:\Program Files\ScaleCmdBridge"
.\nssm.exe set ScaleCmdBridge AppEnvironmentExtra "PORT=8081"
net restart ScaleCmdBridge# Start service
net start ScaleCmdBridge
# Stop service
net stop ScaleCmdBridge
# Check status
sc query ScaleCmdBridge
# View detailed status
sc qc ScaleCmdBridgecd "C:\Program Files\ScaleCmdBridge"
# Start service
.\START-SERVICE.bat
# Stop service
.\STOP-SERVICE.bat
# Reinstall service (if needed)
.\INSTALL-SERVICE.bat
# Remove service
.\UNINSTALL-SERVICE.bat- Service Name:
ScaleCmdBridge - Display Name:
ScaleIT Bridge Service - Start Type: Automatic (starts with Windows)
- Log On: Local System
- Recovery: Restart on failure
# Check service status
sc query ScaleCmdBridge
# Check error logs
Get-Content "C:\ProgramData\ScaleCmdBridge\logs\service-stderr.log" -Tail 50
# Check Windows Event Viewer
eventvwr.msc
# Navigate to: Windows Logs → Application
# Look for "ScaleCmdBridge" entriesCommon causes:
- Port already in use
- Configuration file syntax error
- Missing dependencies
- Permission issues
# Check what's using the port
netstat -ano | findstr :8080
# Change port in service configuration
cd "C:\Program Files\ScaleCmdBridge"
.\nssm.exe set ScaleCmdBridge AppEnvironmentExtra "PORT=8081"
net restart ScaleCmdBridge# Check if service is running
sc query ScaleCmdBridge
# Check firewall
netsh advfirewall firewall show rule name="ScaleCmdBridge"
# Test connection
Invoke-WebRequest http://localhost:8080/health
# Check logs
Get-Content "C:\ProgramData\ScaleCmdBridge\logs\service-stdout.log" -Tail 50# Validate JSON syntax
Get-Content "C:\ProgramData\ScaleCmdBridge\config\devices.json" | ConvertFrom-Json
# Check for syntax errors
# Common issues:
# - Missing commas
# - Unclosed brackets
# - Invalid JSON structure# Check service recovery settings
sc qfailure ScaleCmdBridge
# Enable automatic restart
sc failure ScaleCmdBridge reset= 86400 actions= restart/60000/restart/60000/restart/60000
# Check application logs
Get-Content "C:\ProgramData\ScaleCmdBridge\logs\service-stderr.log" -Tail 100- Open Settings → Apps → Apps & features
- Find ScaleCmdBridge
- Click Uninstall
- Follow the wizard
# 1. Stop and remove service
cd "C:\Program Files\ScaleCmdBridge"
.\UNINSTALL-SERVICE.bat
# 2. Remove firewall rule
netsh advfirewall firewall delete rule name="ScaleCmdBridge"
# 3. Remove files
Remove-Item "C:\Program Files\ScaleCmdBridge" -Recurse -Force
# 4. (Optional) Remove configuration and logs
Remove-Item "C:\ProgramData\ScaleCmdBridge" -Recurse -ForceNote: Configuration and logs in ProgramData are preserved by default. Remove manually if desired.
- Download new installer
- Run as Administrator
- Installer detects existing installation
- Service is stopped automatically
- Configuration is backed up automatically
- Files are replaced
- Service is restarted automatically
- Configuration file (
devices.json) - Log files
- Service settings
- Firewall rules
# 1. Backup configuration
$backupPath = "C:\Backups\ScaleCmdBridge_$(Get-Date -Format 'yyyyMMdd')"
New-Item -ItemType Directory -Path $backupPath -Force
Copy-Item "C:\ProgramData\ScaleCmdBridge\config" "$backupPath\config" -Recurse
# 2. Stop service
net stop ScaleCmdBridge
# 3. Run new installer
# (as Administrator)
# 4. Verify
sc query ScaleCmdBridge
Invoke-WebRequest http://localhost:8080/healthFor detailed update procedures, see: UPDATE_STRATEGY.md
- Service stdout:
C:\ProgramData\ScaleCmdBridge\logs\service-stdout.log - Service stderr:
C:\ProgramData\ScaleCmdBridge\logs\service-stderr.log - Application logs: Configured via
RUST_LOGenvironment variable
NSSM automatically rotates logs:
- Max size: 10 MB per file
- Rotation: Daily
- Retention: 1 backup file
# Real-time log viewing
Get-Content "C:\ProgramData\ScaleCmdBridge\logs\service-stdout.log" -Wait -Tail 50
# Search logs
Select-String -Path "C:\ProgramData\ScaleCmdBridge\logs\*.log" -Pattern "error"The installer automatically creates a firewall rule allowing incoming connections on the configured port. For production:
- Local only: Firewall rule restricts to localhost
- Network access: Modify firewall rule to allow specific IPs
- VPN/Remote: Configure additional firewall rules as needed
The service runs as Local System by default. For enhanced security:
- Create dedicated service account
- Configure NSSM to use service account:
.\nssm.exe set ScaleCmdBridge ObjectName "DOMAIN\ServiceAccount" "Password"
- Configuration file is readable by Local System
- Consider encrypting sensitive connection parameters
- Restrict access to
ProgramData\ScaleCmdBridgedirectory
- Update Strategy: docs/UPDATE_STRATEGY.md
- Build Guide: BUILD_WINDOWS.md
- API Reference: See backend documentation
- Check logs for error messages
- Review troubleshooting section
- Check Windows Event Viewer
- Review GitHub issues
- Contact support
# Service management
net start ScaleCmdBridge
net stop ScaleCmdBridge
sc query ScaleCmdBridge
# Configuration
notepad "C:\ProgramData\ScaleCmdBridge\config\devices.json"
# Logs
Get-Content "C:\ProgramData\ScaleCmdBridge\logs\service-stdout.log" -Tail 50
# Web UI
Start-Process "http://localhost:8080"
# Health check
Invoke-WebRequest http://localhost:8080/healthInstallation: C:\Program Files\ScaleCmdBridge\
Configuration: C:\ProgramData\ScaleCmdBridge\config\
Logs: C:\ProgramData\ScaleCmdBridge\logs\
Service Name: ScaleCmdBridge
Default Port: 8080