Haruno Knowledge base

Automatic updates

Haruno looks for a new version when it opens and every hour after that, then offers to install it. You can also check yourself from the Haruno menu.

  • Mac appAvailable
  • Windows appAvailable

Haruno finds new versions by itself and offers to install them. You do not need to go to the website.

When it checks

  • When Haruno opens.
  • Every hour while it is open.
  • When you ask: Haruno ▸ Check for Updates…. It is right under About Haruno. If there is nothing new, a window tells you which version is the newest.

Haruno only looks while Check for updates automatically is on. It is on at first. With it off, Haruno only checks when you ask.

What you see

When a new version is found, a window titled Software Update opens. It says A new version of Haruno is available! and has three buttons:

  • Install Update
  • Skip This Version
  • Remind Me Later

After you choose Install Update the download starts. When it is ready the button reads Install and Relaunch. Haruno quits, installs the new version and opens again.

If you are in the middle of a chat, a note above the message box says Haruno is installing an update and will restart when it's ready. You can keep typing. Your draft is saved and is back after the restart. Sending waits until Haruno has restarted. If Haruno is still working on something when it is asked to quit, it asks first: Quit while Haruno is still working? You can Quit Anyway or Cancel.

The two switches

In Settings ▸ General ▸ Software Update:

SwitchWhat it does
Check for updates automaticallyHaruno checks for a new version when it opens and every hour after that, and tells you when one is ready
Download and install updates automaticallyInstall a downloaded update the next time you quit Haruno, instead of asking first

The second switch is greyed out while the first is off. It can also be greyed out when this copy of Haruno is not allowed to update itself that way.

What can stop an update

Install Haruno in the Applications folder

An app that is run straight from the disk image or from the Downloads folder cannot update itself. Drag Haruno into the Applications folder and open it from there.

If you skip a version, Haruno does not offer that one again. It offers the next one.

After an update

  • The first time Haruno opens after an update, it can show a page about what is new. See What's New.
  • A new version can need a newer isolated space. If so, it downloads in the background. See Sandbox.

What to tell a customer: Haruno updates itself. They will see a window when there is a new version, choose Install Update, and Haruno restarts. If it does not offer updates, check that it is in the Applications folder.

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)
    What changed
    @@ -0,0 +1,58 @@
    +---
    +title: Automatic updates
    +summary: Haruno looks for a new version when it opens and every hour after that, then offers to install it. You can also check yourself from the Haruno menu.
    +feature: updates
    +covers:
    +  - apple/Sources/HarunoShell/SoftwareUpdate.swift
    +  - apple/Sources/ChatUI/AppUpdateBanner.swift
    +  - apple/App/Info.plist
    +  - apple/docs/release.md
    +---
    +
    +Haruno finds new versions by itself and offers to install them. You do not need to go to the website.
    +
    +## When it checks
    +
    +- When Haruno opens.
    +- Every hour while it is open.
    +- When you ask: <Ui>Haruno ▸ Check for Updates…</Ui>. It is right under <Ui>About Haruno</Ui>. If there is nothing new, a window tells you which version is the newest.
    +
    +Haruno only looks while <Ui>Check for updates automatically</Ui> is on. It is on at first. With it off, Haruno only checks when you ask.
    +
    +## What you see
    +
    +When a new version is found, a window titled <Ui>Software Update</Ui> opens. It says <Ui>A new version of Haruno is available!</Ui> and has three buttons:
    +
    +- <Ui>Install Update</Ui>
    +- <Ui>Skip This Version</Ui>
    +- <Ui>Remind Me Later</Ui>
    +
    +After you choose <Ui>Install Update</Ui> the download starts. When it is ready the button reads <Ui>Install and Relaunch</Ui>. Haruno quits, installs the new version and opens again.
    +
    +If you are in the middle of a chat, a note above the message box says <Ui>Haruno is installing an update and will restart when it's ready.</Ui> You can keep typing. Your draft is saved and is back after the restart. Sending waits until Haruno has restarted. If Haruno is still working on something when it is asked to quit, it asks first: <Ui>Quit while Haruno is still working?</Ui> You can <Ui>Quit Anyway</Ui> or <Ui>Cancel</Ui>.
    +
    +## The two switches
    +
    +In <Ui>Settings ▸ General ▸ Software Update</Ui>:
    +
    +| Switch | What it does |
    +|---|---|
    +| <Ui>Check for updates automatically</Ui> | Haruno checks for a new version when it opens and every hour after that, and tells you when one is ready |
    +| <Ui>Download and install updates automatically</Ui> | Install a downloaded update the next time you quit Haruno, instead of asking first |
    +
    +The second switch is greyed out while the first is off. It can also be greyed out when this copy of Haruno is not allowed to update itself that way.
    +
    +## What can stop an update
    +
    +<Callout variant="warning" title="Install Haruno in the Applications folder">
    +An app that is run straight from the disk image or from the Downloads folder cannot update itself. Drag Haruno into the Applications folder and open it from there.
    +</Callout>
    +
    +If you skip a version, Haruno does not offer that one again. It offers the next one.
    +
    +## After an update
    +
    +- The first time Haruno opens after an update, it can show a page about what is new. See [What's New](/macos/app/whats-new/).
    +- A new version can need a newer isolated space. If so, it downloads in the background. See [Sandbox](/macos/safety/sandbox/).
    +
    +What to tell a customer: Haruno updates itself. They will see a window when there is a new version, choose Install Update, and Haruno restarts. If it does not offer updates, check that it is in the Applications folder.