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 have plans to support Windows and the Web (WASM)! Subscribe to get notified when Warp is available for Windows.

Installing and Running Warp

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

Install using Homebrew by running the command below

brew install --cask warp

Running Warp on Mac

Find the Warp in your Applications folder and run it from there (or search for Warp in Spotlight/Raycast).

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.

Last updated