Check your desktop app version, install an update on macOS, Windows or Linux, and uninstall the app and its data.

On this page

The desktop app never updates itself: it tells you when a newer version is out, and you install it the same way as the first time. The current release is Desktop 1.23.1. This page covers checking your version, updating, and removing the app; for the first install, see Install the desktop app.

Check your version#

Where What it shows
The bottom of Settings Ysra 1.23.1 (build …). Select and copy it when you contact support
About Ysra (the app menu on macOS) The same version and build

Update#

The app looks for a newer version when it starts and regularly while it is open. It only looks: nothing is downloaded or installed until you choose to.

See that a newer version is out#

The bottom of Settings shows Version N is available · Download beside your version.

Download it#

Choose Download. Your browser downloads the file for this computer, the same file as on the install page.

Quit Ysra#

Quit the app first (Quit Ysra from the menu bar or tray). Threads on this computer that were working pause, and continue when you open the app again.

Install it over the old one#

System How
macOS Open the .dmg and drag Ysra into Applications, replacing the old copy
Windows Run Ysra-win-x64.exe
Linux sudo apt install ./Ysra-linux-amd64.deb

Your sign-in, threads, trusted folders and ~/.ysra are kept.

If no update shows#

Symptom Why What to do
A newer version is announced, but Settings shows no Download The app hasn’t checked again yet, or the check didn’t get through Restart the app, or download from the install page; the links always point at the latest release
Still the old version after installing (macOS) The old copy was still running, or the new one went somewhere other than Applications Quit Ysra, then drag it into Applications again and choose Replace
Windows shows “Windows protected your PC” The installer isn’t signed yet More info → Run anyway. See Install on Windows

Uninstall#

System How
macOS Quit Ysra, then drag it from Applications to the Trash
Windows Settings → Apps → Installed apps → Ysra → Uninstall. This also removes Open in Ysra from the folder menu
Linux sudo apt remove ysra-desktop

Uninstalling never touches your project folders or ~/.ssh.

Remove Ysra’s data too#

The app and the CLI share one folder, ~/.ysra. It holds what undo needs, the record of what Ysra did, tools it installed for you, and your machine list.

Warning

Deleting ~/.ysra removes the record undo needs and your machine list. Keep a copy of targets.json if you want your machines back later.

rm -rf ~/.ysra
YsraDocs