Warp is available as a native application on macOS, Linux, and Windows. The installer packages are published at warp.dev/download. Choose your platform below for the full installation steps.
macOS installation
Warp runs natively on macOS using a GPU-accelerated renderer built on wgpu. Both Apple Silicon and Intel Macs are supported.Option 1 — Download the installer
- Go to warp.dev/download and download the
.dmg file.
- Open the
.dmg and drag Warp to your Applications folder.
- Launch Warp from Applications or Spotlight (
Cmd+Space, type Warp).
- macOS may ask you to confirm opening an app downloaded from the internet — click Open.
Option 2 — HomebrewIf you use Homebrew, install Warp with a single command:To upgrade later:macOS system requirements
| Requirement | Minimum |
|---|
| macOS version | macOS 12 Monterey or later |
| Architecture | Apple Silicon (arm64) or Intel (x86_64) |
| GPU | Metal-compatible GPU (all Macs from 2012 onward) |
| RAM | 4 GB |
Linux installation
Warp provides pre-built packages for the two most common Linux package formats. Both x86_64 and arm64 (aarch64) architectures are supported.Debian / Ubuntu (.deb)
- Download the
.deb package from warp.dev/download.
- Install it:
sudo dpkg -i warp-terminal_*.deb
- If there are missing dependencies, resolve them with:
Fedora / RHEL / openSUSE (.rpm)
- Download the
.rpm package from warp.dev/download.
- Install it:
# Fedora / RHEL
sudo rpm -i warp-terminal_*.rpm
# openSUSE
sudo zypper install warp-terminal_*.rpm
Warp on Linux requires a Vulkan-capable GPU driver and a running X11 or Wayland compositor. The package depends on mesa-vulkan-drivers (or an equivalent proprietary driver) for GPU-accelerated rendering via wgpu.
Runtime dependencies
The Warp Linux package depends on the following shared libraries at runtime:
fontconfig — font discoveryzlib1g — compressionlibx11-6, libxcb1, libxi6, libxcursor1, libxkbcommon-x11-0 — X11 input and displaylibwayland-client0, libwayland-egl1 — Wayland supportmesa-vulkan-drivers — open-source Vulkan driverslibegl1 — EGL for GPU rendering
These are installed automatically when using dpkg -i followed by apt-get install -f, or when installing via a package manager that resolves dependencies.Linux system requirements
| Requirement | Minimum |
|---|
| Distribution | Any modern distribution with glibc 2.31+ |
| Architecture | x86_64 or arm64 (aarch64) |
| GPU | Vulkan 1.0-capable GPU with up-to-date drivers |
| Display | X11 or Wayland |
| RAM | 4 GB |
Windows installation
- Go to warp.dev/download and download the Windows
.exe installer.
- Run the installer. If Windows Defender SmartScreen appears, click More info then Run anyway.
- Follow the setup wizard. Warp installs to
%LOCALAPPDATA%\Warp by default.
- Warp launches automatically when the installer finishes. You can also find it in the Start Menu.
Warp on Windows uses a GPU-accelerated renderer via wgpu (DirectX 12 or Vulkan). Make sure your GPU drivers are up to date for the best experience.
Windows system requirements
| Requirement | Minimum |
|---|
| Windows version | Windows 10 (build 19041) or later |
| Architecture | x86_64 |
| GPU | DirectX 12 or Vulkan 1.0-capable GPU |
| RAM | 4 GB |
GPU-accelerated rendering
Warp is built in Rust and uses a custom GPU renderer called WarpUI. On all platforms, rendering is handled by wgpu, a cross-platform graphics API abstraction that targets Metal on macOS, Vulkan on Linux, and DirectX 12 or Vulkan on Windows.
This means Warp renders text, blocks, and UI at native GPU speeds — it does not use Electron, a web view, or a CPU-based renderer.
If Warp fails to start with a GPU error, update your graphics drivers. On Linux, ensure mesa-vulkan-drivers (or a proprietary Vulkan driver) is installed and that DISPLAY or WAYLAND_DISPLAY is set.
First-launch steps
After installation, Warp will guide you through the following on first launch:
Sign in
Log in with your Warp account, or create a free account. An account is required for Agent Mode and cloud features.
Choose your shell
Warp detects your default shell (bash, zsh, fish, or others). You can change the shell at any time in Settings → Features → Terminal.
Import preferences (macOS and Linux)
Warp can import your existing shell prompt, aliases, and environment variables from your current shell configuration files.
Run your first command
You are ready to use Warp. Head to the quickstart guide to run your first command and try Agent Mode. Trying a preview build
Warp publishes a Preview channel with experimental features enabled before they reach the stable release. Download it from warp.dev/download-preview. Preview and stable builds can be installed side by side.
Building from source
Warp’s client is open source under AGPL-3.0. To build and run from source, clone the repository and use the provided scripts:
git clone https://github.com/warpdotdev/warp.git
cd warp
./script/bootstrap # install platform-specific dependencies
./script/run # build and launch Warp
