Skip to content

Update Farero Desktop

Check and install Farero Desktop updates on macOS and Windows, and understand each update status.

Updated 2026-11-10

Check for a desktop update

Open Settings → General and find Farero Desktop. Check now asks for the latest released desktop build. The same status appears in the Connect sheet after you choose Check for Updates… from the desktop tray. Farero Desktop follows released builds even when the connected Farero host follows the beta.

Farero verifies a download before preparing it. When the row says an update is ready, choose Restart to update. The desktop window closes and reopens; agents running in the host continue. On macOS, a prepared update also installs when you quit. On Windows, it installs when you quit or at the next launch.

Read the status

  • Up to date means the last check found no desktop changes. A newer Farero release can still say up to date when its desktop build did not change. Checking, Downloading and Preparing show work in progress; Downloading includes progress.
  • Ready means the download passed verification and can install on restart. Restarting means Farero Desktop is applying it. Updated to v… confirms the new shell started.
  • Waiting for Farero to connect means the shell has no connected host to check against. If the row says the connected Farero is too old, update that host. A remote host must be updated on its own computer. An incompatible update waits for a newer host.
  • Automatic updates are held on this machine means Farero can see a released update but will wait. Choose Download and install to proceed now. Another Farero Desktop window is handling updates means that window owns the check.
  • An unsigned build, an older installer or an update feed this shell cannot read needs the installer link shown in the row. Development builds say updates are off. If an update fails, Farero names the cause and its next automatic attempt; a final error offers Try again, Installer, Learn more and Show log.

Install again when needed

A Farero Desktop copy installed before automatic updates needs one installer run. Use the installer link in Settings or the banner, then open Farero Desktop again. Later desktop updates can install from the app. The installer also repairs an app bundle that Farero cannot replace. Your host and agent work remain separate from the desktop shell.

Download the current macOS installer on an Apple-silicon Mac.

Download the current Windows installer on a Windows x64 computer.

Find the update log

For a final update error, choose Show log to reveal desktop-updates.log in Finder or Explorer. On macOS it is in ~/Library/Application Support/Farero/desktop-updates/. On Windows it is in %LOCALAPPDATA%\Farero\desktop-updates\. The log records the time, update stage, version and cause code. Share only the relevant lines when asking for help.

When the row says Farero will retry, leave the app installed so that attempt can complete. If it says the update is ready, restart the desktop shell when convenient.