Skip to main content

Windows Installation (MSI)

Install MAPS Messaging on Windows using the MSI packages published in the repository. Works on Windows 10/11 and Windows Server (2019+).

Version token: Use {MAPS_VERSION} wherever a version appears (e.g., 4.0.1, 4.1.0-SNAPSHOT).

1) Prerequisites​

  • Administrative privileges.
  • Java 21 available on the system if your MSI does not bundle a runtime.
    • Check: java -version should report 21.x.
    • If your MSI bundles a runtime, you can skip installing JDK.
  • Required ports open (e.g., HTTP API 8080; protocol ports per your config).

2) Download the MSI​

Repository layout:

https://repository.mapsmessaging.io/repository/maps_windows_installer/windows/<full-version>/MapsMessaging-<version>.msi

Using the {MAPS_VERSION} token:

  • https://repository.mapsmessaging.io/repository/maps_windows_installer/windows/{MAPS_VERSION}/MapsMessaging-{MAPS_VERSION}.msi

Examples

  • Release:
    https://repository.mapsmessaging.io/repository/maps_windows_installer/windows/4.0.1/MapsMessaging-4.0.1.msi
  • Snapshot:
    https://repository.mapsmessaging.io/repository/maps_windows_installer/windows/4.1.0-SNAPSHOT/MapsMessaging-4.1.0-SNAPSHOT.msi

PowerShell download

$MAPS_VERSION = "4.0.1"  # or e.g. 4.1.0-SNAPSHOT
$uri = "https://repository.mapsmessaging.io/repository/maps_windows_installer/windows/$MAPS_VERSION/MapsMessaging-$MAPS_VERSION.msi"
$out = "$env:TEMP\MapsMessaging-$MAPS_VERSION.msi"
Invoke-WebRequest -Uri $uri -OutFile $out

3) Install​

GUI​

  • Double‑click the MSI and follow the prompts.

Silent (unattended)​

$msi = "$env:TEMP\MapsMessaging-$MAPS_VERSION.msi"
# Basic UI:
msiexec /i "$msi" /qb

# Or fully silent:
msiexec /i "$msi" /qn

If the installer exposes properties (e.g., install directory), you can pass them as PROPERTY=VALUE on the msiexec line. (Example: INSTALLDIR="C:\MapsMessaging" if supported by your MSI.)

4) Start & Verify​

If a Windows Service is installed, start it via Services (GUI) or PowerShell:

# Replace with the actual service name used by your MSI if different
Get-Service *maps* | Format-Table Name, Status
Start-Service -Name "MapsMessaging"  # if present

Verify the server is responding:

(Invoke-WebRequest http://localhost:8080/api/v1/ping).Content      # {"status":"Success"}
(Invoke-WebRequest http://localhost:8080/health).Content           # OK | Warning | Error

If the MSI doesn’t install a service, use the start script:

cd "C:\Program Files\MapsMessaging"   # or your chosen install dir
bin\start.bat

5) Upgrades​

  • Download the newer MSI for the target version.
  • Run the MSI (GUI or silent as above). Most packages upgrade in place; if prompted, uninstall the previous version first.
  • Restart the service (if installed as a service).

Tip: Back up your conf\ directory before upgrading.

6) Uninstall​

Control Panel → Apps & Features → Maps Messaging → Uninstall, or:

# Using the original MSI path:
msiexec /x "$env:TEMP\MapsMessaging-$MAPS_VERSION.msi"

# Or via product name from registry (example using winget if available):
winget uninstall "Maps Messaging"  # adjust to exact product display name