# Updating Warp

Warp automatically checks for updates on startup. A notification will appear in the top right corner of the Warp window when a new update is available.

![Update Available](https://2974137108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD4dBaHbuMVNs0iB2iqZ1%2Fuploads%2Fgit-blob-976978f8711aaeb81d33778ed5c3a9d0a5820831%2Fupdate-available.png?alt=media)

To check for updates, search for "update" in the [Command Palette](https://docs.warp.dev/terminal/command-palette) or go to **Settings** > **Account** and click "Check for Update".

![Check for Update manually](https://2974137108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD4dBaHbuMVNs0iB2iqZ1%2Fuploads%2Fgit-blob-99ab35e6148db2f437666654403f1e91bcb92151%2Fcheck-for-update.gif?alt=media)

If nothing happens, it means you already have the latest stable build.

## macOS: Auto-update permissions issues

Warp cannot auto-update if it does not have the correct permissions to replace the running version of Warp. If this is the case, a banner will prompt you to manually update Warp.

![Update Available](https://2974137108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD4dBaHbuMVNs0iB2iqZ1%2Fuploads%2Fgit-blob-5b32279175fc86324225ee14a9eb1b38db1f8489%2Fupdate-available-bar.png?alt=media)

There are 2 main causes of this:

1. You opened Warp directly from the mounted volume instead of dragging it into your Applications directory. If this is the case, the easiest fix is to quit Warp, drag the application into /Applications, and restart Warp.
2. You are a non-Admin user. This can happen if you use a computer with multiple profiles. If you have admin access on the computer, opening the app with the admin user should fix the auto-update issues.

{% hint style="info" %}
(Oct 2022): There is a known issue with [auto-update on macOS Ventura](https://docs.warp.dev/support-and-community/known-issues#auto-update-on-macos-ventura).
{% endhint %}

## Linux: Refreshing the package signing key

If you encounter signature verification errors when trying to update Warp on Linux, you may need to refresh the package signing key. This can happen if the key on your system has expired.

### Debian / Ubuntu (apt)

You may see an error like the following:

```
W: GPG error: https://releases.warp.dev/linux/deb stable Release: The following signatures were invalid: EXPKEYSIG 31F4254AFE49E02E Warp Linux Maintainers (Package Signing Authority) <linux-maintainers@warp.dev>
E: The repository 'https://releases.warp.dev/linux/deb stable Release' is not signed.
```

To fetch the updated signing key, run:

```bash
curl -fsSL https://releases.warp.dev/linux/keys/warp.asc | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/warpdotdev.gpg > /dev/null
```

Then retry your update:

```bash
sudo apt update && sudo apt install warp-terminal
```

### Fedora / RHEL / CentOS (dnf/yum)

You may see an error like the following:

```
OpenPGP check for package "warp-terminal-v0.2026.01.28.08.14.stable_04-1.x86_64" (/var/cache/libdnf5/warpdotdev-4ac10ef632833104/packages/warp-terminal-v0.2026.01.28.08.14.stable_04-1.x86_64.rpm) from repo "warpdotdev" has failed: Problem occurred when opening the package.
```

To fetch the updated signing key, run:

```bash
sudo rpm --import https://releases.warp.dev/linux/keys/warp.asc
```

Then retry your update:

```bash
sudo dnf upgrade warp-terminal
# or for older systems:
sudo yum upgrade warp-terminal
```

### Arch Linux (pacman)

You may see an error like the following:

```
error: warpdotdev: signature from "Warp Linux Maintainers (Package Signing Authority) <linux-maintainers@warp.dev>" is expired
```

To fetch the updated signing key, run:

```bash
sudo pacman-key --recv-keys "linux-maintainers@warp.dev" --keyserver hkp://keys.openpgp.org:80
sudo pacman-key --lsign-key "linux-maintainers@warp.dev"
```

Then retry your update:

```bash
sudo pacman -Syu warp-terminal
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.warp.dev/support-and-community/troubleshooting-and-support/updating-warp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.