Quickstart Guide

Learn how to install Warp and get it running on your machine.

Platform support: Warp is currently supported on Mac (Intel and Mac Silicon) and Linux (x86_64 and ARM64). We have plans to support Windows and the Web (WASM)!

Subscribe to get notified when Warp is available for Windows.

Install Warp

Visit Known Issues to get more details on setting up and troubleshooting Warp.

macOS

Minimum requirements: Intel or Apple silicon macOS 10.14 or above and hardware that supports Metal.

You can install Warp in two ways:

1. Download Warp and drag into your Applications folder

Warp

1. Install using Homebrew by running the command below

brew install --cask warp

After installation, you can find Warp in your Applications folder.

Linux

Requirements: Minimum requirements are an x64 or ARM64 Linux distribution with glibc >= 2.31 (released Feb. 2020) and support for either OpenGL ES 3.0+ or Vulkan. We are tracking support requests for 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 x64 .deb package or ARM64 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.

Alternatively, you can manually configure the Warp apt repository and install Warp by running the following commands:

sudo apt-get install wget gpg
wget -qO- https://releases.warp.dev/linux/keys/warp.asc | gpg --dearmor > warpdotdev.gpg
sudo install -D -o root -g root -m 644 warpdotdev.gpg /etc/apt/keyrings/warpdotdev.gpg
sudo sh -c 'echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/warpdotdev.gpg] https://releases.warp.dev/linux/deb stable main" > /etc/apt/sources.list.d/warpdotdev.list'
rm warpdotdev.gpg
sudo apt update && sudo apt install warp-terminal

RHEL-, Fedora-, and CentOS-based distributions

The easiest way to install Warp is to download the x64 .rpm package or ARM64 .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.

Alternatively, you can manually configure the Warp yum repository and install Warp by running the following commands:

sudo rpm --import https://releases.warp.dev/linux/keys/warp.asc
sudo sh -c 'echo -e "[warpdotdev]\nname=warpdotdev\nbaseurl=https://releases.warp.dev/linux/rpm/stable\nenabled=1\ngpgcheck=1\ngpgkey=https://releases.warp.dev/linux/keys/warp.asc" > /etc/yum.repos.d/warpdotdev.repo'
sudo dnf install warp-terminal

Arch Linux-based distributions

The easiest way to install Warp is to download the x64 .pkg.tar.zst package or ARM64 pacman 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 manually configure the Warp pacman repository and install Warp 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 "[e-mail]"
sudo pacman-key --lsign-key "[e-mail]"
sudo pacman -Sy warp-terminal

OpenSUSE- and SLE-based distributions

The Warp yum repository also works for OpenSUSE- and SLE-based systems. Download the x64 .rpm package or ARM64 .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.

Alternatively, you can manually configure the Warp yum repository and install Warp by running the following commands:

sudo rpm --import https://releases.warp.dev/linux/keys/warp.asc
sudo sh -c 'echo -e "[warpdotdev]\nname=warpdotdev\ntype=rpm-md\nbaseurl=https://releases.warp.dev/linux/rpm/stable\nenabled=1\nautorefresh=1\ngpgcheck=1\ngpgkey=https://releases.warp.dev/linux/keys/warp.asc\nkeeppackages=0" > /etc/zypp/repos.d/warpdotdev.repo'
sudo zypper install warp-terminal

AppImage

We also provide an AppImage, a single-file executable version of Warp. Installing Warp via a package manager is recommended, as it will ensure your system has all necessary dependencies installed.

You can download the Warp AppImage with the following commands:

# On x64 systems
curl -L "https://app.warp.dev/download?package=appimage" -o Warp-x64.AppImage
chmod +x Warp-x64.AppImage

# On ARM64 systems
curl -L "https://app.warp.dev/download?package=appimage_arm64" -o Warp-ARM64.AppImage
chmod +x Warp-ARM64.AppImage

Running Warp on Linux

If you installed a package, find Warp in your desktop manager or run warp-terminal on your terminal. If you're using the AppImage, you can launch it by navigating to the directory where the AppImage is located and running ./Warp-*.AppImage.

Initial Setup

Log in to Warp

After installation, you will be prompted to sign up for a Warp account. You have the option to skip this step. If you're having issues logging in, you can check out the Login Troubleshooting page.

If you sign up using Google or GitHub, Warp only gets access to the associated email address. Visit the Privacy page for more details on Warp's approach to privacy.

Use Warp offline

You will only need an active internet connection when you open the Warp app for the first time. Once opened, Warp is able to run with no internet connection, although certain features that require an internet connection will be unavailable.

Import your settings

If you are migrating to Warp from another terminal like iTerm2, you can easily import your settings, such as keyboard shortcuts and color themes. For more details, visit the Migrate to Warp docs.

Set up your Warp default shell

Warp tries to load your login shell by default. Currently, Warp supports bash, fish, zsh, and PowerShell (pwsh). If your login shell is set to something else (for example, Nushell) Warp will load zsh by default.

Zsh is the default login and interactive shell on macOS (starting with macOS Catalina in 2019), replacing the bash shell. For most Linux distributions, the default shell is bash.

You can change your default shell by going to Settings > Features > Session. In the Startup shell for new sessions section, you can choose which shell you want Warp to use.

Customize Warp's Appearance

Warp has many Appearance settings you can configure:

• Themes: You can choose from pre-loaded themes or create your own custom theme, using .yaml or based on a background image you upload.

• Text and fonts: You can customize your font type and font size. You can also adjust the font to improve readability and accessibility.

• Input position: Set your prompt and command line to the top or bottom of your terminal window.

Navigate to Settings > Appearance to customize your setup.

Settings > Appearance

Modify behavior settings

There are a number of behavior settings and features that will help you customize your terminal to best suit your needs:

• Dedicated window: Dedicated hotkey window (also known as Quake Mode) allows you to customize your window’s position, width, and height ratio relative to your active screen size.

• Tabs: Organize your windows into multiple terminal sessions, and customize them with different titles and/or colors.

• Split panes: Divide any tab into multiple panels, side-by-side or stacked.

Organize tabs and divide them into multiple panels

• Auto suggestions: As you type, Warp will automatically suggest commands based on shell history and possible completions.

• Completions: When you press TAB, Warp will suggest commands, option names, and path parameters for you. Customize your TAB key behavior under Settings > Features.

• Vim keybindings: Warp supports default Vim keybindings, allowing for keyboard-driven text editing.

• Keyboard shortcuts: Warp supports commonly used keyboard shortcuts. You can also set custom keyboard shortcuts by creating new commands or editing existing shortcuts.

• Open files and links: Using your cursor, you can open files, folders, and URL links that are within Blocks. You can also configure the default editor to open files.

• Command Corrections: Get auto-correct suggestions on commands to catch typos, forgotten flags, and general console errors.