Installing & Onboarding

A step-by-step guide for setting up Warp on your machine.
Platform support: Warp is currently supported on Mac (both Intel and Mac Silicon) and Linux (x86_64). We plan on adding support for Windows soon. Subscribe to get notified when Warp is available for Windows.

Installing Warp

macOS
Linux
Requirements: Minimum requirements are macOS 10.14 or above and hardware that supports Metal.
There are two ways to get Warp onto your machine:
Download Warp at the link below and Drag into your Application folder
Warp
Link to Download Warp
Install using Homebrew by running the command below
brew install --cask warp
Requirements: Minimum requirement is a x86_64 Linux distribution with glibc >= 2.31 (released Feb. 2020) and support for either OpenGL ES 3.0+ or Vulkan. We plan on adding support for ARM and WSL.
This includes (but is not limited to) the following:
  • Ubuntu 20.04
  • Debian 11 ("bullseye")
  • Fedora 32
  • Arch Linux
Visit the Warp download page for the full list of available installation options. All installation options support auto-update, ensuring you receive new features, bug fixes, and performance improvements.

Debian- and Ubuntu-based distributions

The easiest way to install Warp is to download and install the .deb package. After downloading, you can install the package with:
sudo apt install ./<file>.deb
Installing the .deb package will automatically set up the Warp apt repository and signing key needed to automatically update Warp and verify the integrity of the downloaded packages.

RHEL-, Fedora-, and CentOS-based distributions

The easiest way to install Warp is to download and install the .rpm package. After downloading, you can install the package with:
sudo dnf install ./<file>.rpm
Installing the .rpm package will automatically set up the Warp yum repository. On first update, dnf will retrieve the signing key needed to verify the integrity of the downloaded packages.

Arch Linux-based distributions

The easiest way to install Warp is to download and install the .pkg.tar.zst package. After downloading, you can install the package with:
sudo pacman -U ./<file>.pkg.tar.zst
The first time you update Warp through the app, it will guide you through setting up the Warp pacman repository and signing key. Alternatively, you can do so manually by running the following commands:
sudo sh -c "echo -e '\n[warpdotdev]\nServer = https://releases.warp.dev/linux/pacman/\$repo/\$arch' >> /etc/pacman.conf"
sudo pacman-key -r "[email protected]"
sudo pacman-key --lsign-key "[email protected]"

OpenSUSE- and SLE-based distributions

The Warp yum repository also works for OpenSUSE- and SLE-based systems. Download and install the .rpm package. After downloading, you can install the package with:
sudo zypper install ./<file>.rpm
Installing the .rpm package will automatically set up the Warp yum repository. On first update, zypper will retrieve the signing key needed to verify the integrity of the downloaded packages.

AppImage

We also provide an AppImage (https://appimage.org), a single-file executable version of Warp. Installing Warp via a package manager is recommended, however, as it will ensure your system has all necessary dependencies installed.
You can download and run the Warp AppImage with the following commands:
curl -L "https://app.warp.dev/download?package=appimage" -o Warp-x86_64.AppImage
chmod +x Warp-x86_64.AppImage
./Warp-x86_64.AppImage

Shell Compatibility

Locally, the terminal integrates with bash, zsh, or fish. Reference Using Warp with [bash|zsh|fish] for more details.
Visit known issues to get more details on setting up and troubleshooting Warp.

Onboarding

Logging into Warp (Required)

Unlike classic terminals, Warp requires you to sign up and log in to get started with the app. Unique user identity is required to support Warp's collaborative features and it makes it easier for the Warp team to provide customer support, should you need to debug an issue.
Issues with login? Check out the login troubleshooting page.
After installing Warp for the first time, you will be prompted to log in with GitHub, Google, or with an email link.
If you log in with Google or GitHub, Warp only gets access to the associated email address. If you want to learn more, read our approach to privacy.
Opening the app is the only time you need an active internet connection. Otherwise, Warp is a fully-native, local app that runs fine with no internet connection (although you will lose access to some cooler features).

Onboarding Survey (Optional)

Warp will ask a few questions within the app after you sign up.
The survey is optional. You can skip all questions if you’d like.
Why do we ask these? Understanding how you use the terminal helps us improve the product and prioritize the right features to build.

Customizing Warp

Warp has many Appearance settings you can configure, including themes, fonts, opacity, and input position. Navigate to Settings > Appearance to customize your setup.