Update and uninstall
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
Related#
- Install the desktop app: downloads and the first launch.
- Troubleshooting: when an update doesn’t install or start.
- What’s new: what changed in each release.