” marker just before .

Publish New harmon.ie Desktop App Updates From Your Own Server

By default, desktop app updates are automatic. Whenever harmon.ie publishes a new version, the app either updates automatically (when deployed from the Microsoft Store) or prompts each user to update it (when installed from an .msi).

To control when your users receive a new version, for example so you can test it first, you can host the update on your own server. Users are offered the new version only after you publish it.

Download and test the new version

Download the latest version of the harmon.ie Desktop app, as an .msi package, from the harmon.ie download page. Test it before you roll it out to your users.

Publish the update

When you have finished testing and are ready to deploy the new version:

  1. Host the .msi package on your server.
  2. Get the SHA-256 hash of the .msi package. In PowerShell, run: 
    Get-FileHash -Algorithm SHA256 "<path-to-msi>"
  3. Update the latest.json file with the new version’s details. Download latest.zip, extract it, and set:
    • latestVersion – the version number of the .msi package.
    • latestUrl – the URL of the .msi package on your server.
    • sha256 – the hash from the previous step.

    Example:

    {
  "latestVersion": "2.1.0",
  "latestUrl": "https://your-server/harmonie-updates/New-harmonie-2.1.0.msi",
  "sha256": "6cf4143251439bd645e7661da4833d4bdb840c4cd9a51d05ec2fc2c25a0e5c8b"
}
  4. Save latest.json on the same server as the .msi package, for security.
  5. Point the desktop app to the latest.json location: in the desktop app’s configuration file (Harmonie.Desktop.Companion.dll.config), set updateUrl to the URL where you saved latest.json. You set this once; to publish later versions, repeat steps 1 to 4.

    Example:

    {
    "updateUrl": "https://your-server/harmonie-updates/"
}
Users stay on their current version until you publish a latest.json with a higher latestVersion. This lets you test a new version before you make it available.

How users update

Each desktop app checks your server for a newer version. When one is available, an update button appears in harmon.ie. When users click it, the app downloads the .msi from latestUrl, verifies it against the sha256 hash, then closes, updates, and reopens.

–>