Haruno Knowledge base

Automatic updates

Haruno for Windows finds a new version by itself, downloads it quietly and installs it when you restart. A switch in Settings turns the checking off, and About lets you check by hand.

  • Mac appAvailable
  • Windows appAvailable

Haruno for Windows keeps itself current. It looks for a new version in the background, downloads it, and installs it the next time Haruno restarts. You do not run a setup program again.

How it works

  1. About a minute after Haruno starts, and then once an hour, it asks whether a newer version is on offer.
  2. If there is one, it downloads it in the background while you work.
  3. Before it keeps the download, Haruno checks that it is the genuine one, signed by the Haruno team. A download that fails the check is thrown away.
  4. When the download is ready, Restart to update appears at the bottom of the left-hand menu.
  5. You press it. Haruno closes, swaps in the new version and opens again.
Restart to update appears in the menu once a new version is ready.
The left-hand menu of Haruno with a Restart to update entry above Settings and About.The left-hand menu of Haruno with a Restart to update entry above Settings and About.

If you close Haruno without pressing the button, the update is installed the next time you open it. An update replaces the program only. Your chats, settings and connected accounts stay where they are.

If Haruno is busy

If Haruno is still working on something when you press Restart to update, it asks "Quit while Haruno is still working?". Choose Quit Anyway to restart now, or Cancel to let the work finish first.

Check by hand

Open About from the menu. It shows the version you have and a line that says where things stand.

About shows your version and lets you check for an update.
The About page showing the Haruno name, the version number, the line No update is available and a Check for updates button.The About page showing the Haruno name, the version number, the line No update is available and a Check for updates button.

Press Check for updates to look right now. You may see:

What About saysWhat it means
No update is available.Nothing newer is on offer to you.
Checking for updates…Haruno is asking.
Downloading update… 40%The new version is on its way.
Installing update…Haruno is getting the download ready.
Version X is available.The update is ready. Press Restart to update.
Download interrupted at 62%. Resume to carry on from there.The download stopped part way. Press Resume download and it carries on from the same point.
There isn't enough free disk space to finish the download. Free some space, then resume.Free some room on the PC, then press Resume download.
Couldn't check for updates. Try again later.Haruno could not reach the update service. It tries again on its own every hour.
Couldn't verify the update, so it wasn't installed. Try again later.The download did not pass the check, so Haruno did not use it.

The Automatic updates switch

Settings ▸ General ▸ Automatic updates is on by default. Its own description reads: "Download updates in the background and apply them on restart."

The Automatic updates switch is in the General tab of Settings.
The General tab of Settings. Near the bottom, the Automatic updates row has a switch that is turned on.The General tab of Settings. Near the bottom, the Automatic updates row has a switch that is turned on.

With the switch off, Haruno stops looking for updates by itself and does not install a waiting update when it starts. Check for updates on the About page still works, and so does Restart to update once a download is ready. Turning the switch off also hides a waiting Restart to update until you check again.

When Haruno cannot update itself

If Haruno cannot replace its own files, for example because the folder it is installed in is locked down, it cannot swap in the new version by itself. It then shows Version X available in the menu instead, and About offers Open download page, which opens the new version's download in your browser.

There is no Beta choice for customers

Older notes mention a Stable or Beta update channel in Settings. The customer version of Haruno has no such setting, only the Automatic updates switch. The channel choice exists only in the builds the Haruno team uses to test. A customer always gets the version the Haruno team has released to them.

What to tell a customer

  • A new version reaches customers only after the Haruno team has released it to them. You may hear about a version before the app offers it.
  • Haruno never moves to an older version on its own. If the team pulls a version back before you restart, Haruno drops the download it had made, and the Restart to update button goes away.
  • Connectors and the Portfolio update separately and need no restart of the app. See Plugins.

Last updated · PR #2944 · View this version on GitHub

History (1 version)
  1. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    PR #2944Commit a2a7836The page at this version
    What changed
    @@ -0,0 +1,72 @@
+---
+title: Automatic updates
+summary: Haruno for Windows finds a new version by itself, downloads it quietly and installs it when you restart. A switch in Settings turns the checking off, and About lets you check by hand.
+feature: updates
+covers:
+  - windows-client/docs/auto-update.md
+  - windows-client/Haruno.Updater/**
+  - windows-client/Haruno.Desktop.Services/Updates/**
+  - windows-client/Haruno.Desktop.ViewModels/AboutViewModel.cs
+  - windows-client/haruno-webview/web/src/pages/AboutPage.tsx
+  - windows-client/haruno-client/BuildConfiguration.cs
+---
+
+Haruno for Windows keeps itself current. It looks for a new version in the background, downloads it, and installs it the next time Haruno restarts. You do not run a setup program again.
+
+## How it works
+
+1. About a minute after Haruno starts, and then once an hour, it asks whether a newer version is on offer.
+2. If there is one, it downloads it in the background while you work.
+3. Before it keeps the download, Haruno checks that it is the genuine one, signed by the Haruno team. A download that fails the check is thrown away.
+4. When the download is ready, **Restart to update** appears at the bottom of the left-hand menu.
+5. You press it. Haruno closes, swaps in the new version and opens again.
+
+<Shot src="/m/26b9d2706adb-windows-updates-restart-light.png" dark="/m/f6e87614d6b2-windows-updates-restart-dark.png" alt="The left-hand menu of Haruno with a Restart to update entry above Settings and About." caption="Restart to update appears in the menu once a new version is ready." />
+
+If you close Haruno without pressing the button, the update is installed the next time you open it. An update replaces the program only. Your chats, settings and connected accounts stay where they are.
+
+<Callout variant="info" title="If Haruno is busy">
+If Haruno is still working on something when you press **Restart to update**, it asks "Quit while Haruno is still working?". Choose **Quit Anyway** to restart now, or **Cancel** to let the work finish first.
+</Callout>
+
+## Check by hand
+
+Open **About** from the menu. It shows the version you have and a line that says where things stand.
+
+<Shot src="/m/4d55e7db3dcc-windows-updates-about-light.png" dark="/m/d604b8379e94-windows-updates-about-dark.png" alt="The About page showing the Haruno name, the version number, the line No update is available and a Check for updates button." caption="About shows your version and lets you check for an update." />
+
+Press <Ui>Check for updates</Ui> to look right now. You may see:
+
+| What About says | What it means |
+|---|---|
+| No update is available. | Nothing newer is on offer to you. |
+| Checking for updates… | Haruno is asking. |
+| Downloading update… 40% | The new version is on its way. |
+| Installing update… | Haruno is getting the download ready. |
+| Version X is available. | The update is ready. Press <Ui>Restart to update</Ui>. |
+| Download interrupted at 62%. Resume to carry on from there. | The download stopped part way. Press <Ui>Resume download</Ui> and it carries on from the same point. |
+| There isn't enough free disk space to finish the download. Free some space, then resume. | Free some room on the PC, then press <Ui>Resume download</Ui>. |
+| Couldn't check for updates. Try again later. | Haruno could not reach the update service. It tries again on its own every hour. |
+| Couldn't verify the update, so it wasn't installed. Try again later. | The download did not pass the check, so Haruno did not use it. |
+
+## The Automatic updates switch
+
+<Ui>Settings ▸ General ▸ Automatic updates</Ui> is on by default. Its own description reads: "Download updates in the background and apply them on restart."
+
+<Shot src="/m/dd89187378d0-windows-updates-settings-light.png" dark="/m/6c50854a0750-windows-updates-settings-dark.png" alt="The General tab of Settings. Near the bottom, the Automatic updates row has a switch that is turned on." caption="The Automatic updates switch is in the General tab of Settings." />
+
+With the switch off, Haruno stops looking for updates by itself and does not install a waiting update when it starts. <Ui>Check for updates</Ui> on the About page still works, and so does <Ui>Restart to update</Ui> once a download is ready. Turning the switch off also hides a waiting **Restart to update** until you check again.
+
+## When Haruno cannot update itself
+
+If Haruno cannot replace its own files, for example because the folder it is installed in is locked down, it cannot swap in the new version by itself. It then shows **Version X available** in the menu instead, and About offers <Ui>Open download page</Ui>, which opens the new version's download in your browser.
+
+<Callout variant="warning" title="There is no Beta choice for customers">
+Older notes mention a Stable or Beta update channel in Settings. The customer version of Haruno has no such setting, only the Automatic updates switch. The channel choice exists only in the builds the Haruno team uses to test. A customer always gets the version the Haruno team has released to them.
+</Callout>
+
+## What to tell a customer
+
+- A new version reaches customers only after the Haruno team has released it to them. You may hear about a version before the app offers it.
+- Haruno never moves to an older version on its own. If the team pulls a version back before you restart, Haruno drops the download it had made, and the **Restart to update** button goes away.
+- Connectors and the Portfolio update separately and need no restart of the app. See [Plugins](/windows/app/plugins/).