> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/warpdotdev/warp/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Warp on macOS, Linux, and Windows

> Step-by-step installation instructions for Warp on macOS, Linux (x86_64 and arm64), and Windows, including system requirements and first-launch setup.

Warp is available as a native application on macOS, Linux, and Windows. The installer packages are published at [warp.dev/download](https://www.warp.dev/download). Choose your platform below for the full installation steps.

<Tabs>
  <Tab title="macOS">
    ## macOS installation

    Warp runs natively on macOS using a GPU-accelerated renderer built on [wgpu](https://wgpu.rs/). Both Apple Silicon and Intel Macs are supported.

    **Option 1 — Download the installer**

    1. Go to [warp.dev/download](https://www.warp.dev/download) and download the `.dmg` file.
    2. Open the `.dmg` and drag **Warp** to your **Applications** folder.
    3. Launch Warp from **Applications** or Spotlight (`Cmd+Space`, type `Warp`).
    4. macOS may ask you to confirm opening an app downloaded from the internet — click **Open**.

    **Option 2 — Homebrew**

    If you use Homebrew, install Warp with a single command:

    ```bash theme={null}
    brew install --cask warp
    ```

    To upgrade later:

    ```bash theme={null}
    brew upgrade --cask warp
    ```

    ### 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                                             |
  </Tab>

  <Tab title="Linux">
    ## 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)**

    1. Download the `.deb` package from [warp.dev/download](https://www.warp.dev/download).
    2. Install it:

    ```bash theme={null}
    sudo dpkg -i warp-terminal_*.deb
    ```

    3. If there are missing dependencies, resolve them with:

    ```bash theme={null}
    sudo apt-get install -f
    ```

    **Fedora / RHEL / openSUSE (.rpm)**

    1. Download the `.rpm` package from [warp.dev/download](https://www.warp.dev/download).
    2. Install it:

    ```bash theme={null}
    # Fedora / RHEL
    sudo rpm -i warp-terminal_*.rpm

    # openSUSE
    sudo zypper install warp-terminal_*.rpm
    ```

    <Note>
      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.
    </Note>

    ### Runtime dependencies

    The Warp Linux package depends on the following shared libraries at runtime:

    * `fontconfig` — font discovery
    * `zlib1g` — compression
    * `libx11-6`, `libxcb1`, `libxi6`, `libxcursor1`, `libxkbcommon-x11-0` — X11 input and display
    * `libwayland-client0`, `libwayland-egl1` — Wayland support
    * `mesa-vulkan-drivers` — open-source Vulkan drivers
    * `libegl1` — 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                                           |
  </Tab>

  <Tab title="Windows">
    ## Windows installation

    1. Go to [warp.dev/download](https://www.warp.dev/download) and download the Windows `.exe` installer.
    2. Run the installer. If Windows Defender SmartScreen appears, click **More info** then **Run anyway**.
    3. Follow the setup wizard. Warp installs to `%LOCALAPPDATA%\Warp` by default.
    4. Warp launches automatically when the installer finishes. You can also find it in the **Start Menu**.

    <Note>
      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.
    </Note>

    ### 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                                 |
  </Tab>
</Tabs>

## GPU-accelerated rendering

Warp is built in Rust and uses a custom GPU renderer called **WarpUI**. On all platforms, rendering is handled by [wgpu](https://wgpu.rs/), 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.

<Tip>
  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.
</Tip>

## First-launch steps

After installation, Warp will guide you through the following on first launch:

<Steps>
  <Step title="Sign in">
    Log in with your Warp account, or create a free account. An account is required for Agent Mode and cloud features.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="Import preferences (macOS and Linux)">
    Warp can import your existing shell prompt, aliases, and environment variables from your current shell configuration files.
  </Step>

  <Step title="Run your first command">
    You are ready to use Warp. Head to the [quickstart guide](/quickstart) to run your first command and try Agent Mode.
  </Step>
</Steps>

## 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](https://www.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:

```bash theme={null}
git clone https://github.com/warpdotdev/warp.git
cd warp
./script/bootstrap   # install platform-specific dependencies
./script/run         # build and launch Warp
```

See [WARP.md](https://github.com/warpdotdev/warp/blob/main/WARP.md) in the repository for the full engineering guide, including coding style, testing, and platform-specific notes.