# Updates

Automatic update checks, downloads, and restarting Rip.


Rip checks for updates at launch and every 24 hours while it stays open. Downloads run in the background.

## Use it

When an update is ready, the status bar shows **Restart to update**. Click it to open the update details.

Click **Restart to update** in that window to install the update. Rip reopens your folders, file tabs, and unsaved buffers.

Rip then opens the new version's release notes in a read-only tab. The notes appear once after the update and work offline.

If Rip cannot preserve your unsaved buffers, it stops the restart. Save your files before you try again.

Run `rip: check for updates` from the command palette to check at any time. On macOS, you can also use **Check for Updates** in the Rip menu.

## Behavior

On macOS, automatic installation requires a signed release app in a writable folder. Move the app out of its disk image before updating.

On Linux, portable installations can update themselves. For installations from APT, RPM, or Arch packages, Rip shows an update notice. Use your package manager to install the update.

Development builds do not check for updates. Rip checks downloaded files before installation. A failed download leaves the installed app unchanged.

## Settings

Set `auto-update = false` to stop automatic checks and downloads. Manual checks remain available.

| Key | Default | Effect |
| --- | --- | --- |
| `auto-update` | `true` | Check at launch and daily, then download updates. Restart requires your action. |