installation.md

  1---
  2title: Install Zed - macOS, Linux, Windows
  3description: Download and install Zed on macOS, Linux, or Windows. Includes Homebrew, direct download, and package manager options.
  4---
  5
  6# Installing Zed
  7
  8## Download Zed
  9
 10### macOS
 11
 12Get the latest stable builds via [the download page](https://zed.dev/download). If you want to download our preview build, you can find it on its [releases page](https://zed.dev/releases/preview). After the first manual installation, Zed will periodically check for install updates.
 13
 14You can also install Zed stable via Homebrew:
 15
 16```sh
 17brew install --cask zed
 18```
 19
 20As well as Zed preview:
 21
 22```sh
 23brew install --cask zed@preview
 24```
 25
 26### Windows
 27
 28Get the latest stable builds via [the download page](https://zed.dev/download). If you want to download our preview build, you can find it on its [releases page](https://zed.dev/releases/preview). After the first manual installation, Zed will periodically check for install updates.
 29
 30Additionally, you can install Zed using winget:
 31
 32```sh
 33winget install -e --id ZedIndustries.Zed
 34```
 35
 36### Linux
 37
 38For most Linux users, the easiest way to install Zed is through our installation script:
 39
 40```sh
 41curl -f https://zed.dev/install.sh | sh
 42```
 43
 44You can now optionally specify a **version** of Zed to install using the `ZED_VERSION` environment variable:
 45
 46```sh
 47# Install the latest stable version (default)
 48curl -f https://zed.dev/install.sh | sh
 49
 50# Install a specific version
 51curl -f https://zed.dev/install.sh | ZED_VERSION=0.216.0 sh
 52```
 53
 54To install the preview build, which receives updates about a week ahead of stable:
 55
 56```sh
 57curl -f https://zed.dev/install.sh | ZED_CHANNEL=preview sh
 58```
 59
 60This script supports `x86_64` and `AArch64`, as well as common Linux distributions: Ubuntu, Arch, Debian, RedHat, CentOS, Fedora, and more.
 61
 62If Zed is installed using this installation script, it can be uninstalled at any time by running the shell command `zed --uninstall`. The shell will then prompt you whether you'd like to keep your preferences or delete them. After making a choice, you should see a message that Zed was successfully uninstalled.
 63
 64If this script is insufficient for your use case, you run into problems running Zed, or there are errors in uninstalling Zed, please see our [Linux-specific documentation](./linux.md).
 65
 66## System Requirements
 67
 68### macOS
 69
 70Zed supports the follow macOS releases:
 71
 72| Version       | Codename | Apple Status   | Zed Status          |
 73| ------------- | -------- | -------------- | ------------------- |
 74| macOS 26.x    | Tahoe    | Supported      | Supported           |
 75| macOS 15.x    | Sequoia  | Supported      | Supported           |
 76| macOS 14.x    | Sonoma   | Supported      | Supported           |
 77| macOS 13.x    | Ventura  | Supported      | Supported           |
 78| macOS 12.x    | Monterey | EOL 2024-09-16 | Supported           |
 79| macOS 11.x    | Big Sur  | EOL 2023-09-26 | Partially Supported |
 80| macOS 10.15.x | Catalina | EOL 2022-09-12 | Partially Supported |
 81
 82The macOS releases labelled "Partially Supported" (Big Sur and Catalina) do not support screen sharing via Zed Collaboration. These features use the [LiveKit SDK](https://livekit.io) which relies upon [ScreenCaptureKit.framework](https://developer.apple.com/documentation/screencapturekit/) only available on macOS 12 (Monterey) and newer.
 83
 84#### Mac Hardware
 85
 86Zed supports machines with Intel (x86_64) or Apple (aarch64) processors that meet the above macOS requirements:
 87
 88- MacBook Pro (Early 2015 and newer)
 89- MacBook Air (Early 2015 and newer)
 90- MacBook (Early 2016 and newer)
 91- Mac Mini (Late 2014 and newer)
 92- Mac Pro (Late 2013 or newer)
 93- iMac (Late 2015 and newer)
 94- iMac Pro (all models)
 95- Mac Studio (all models)
 96
 97### Linux
 98
 99Zed supports 64-bit Intel/AMD (x86_64) and 64-bit Arm (aarch64) processors.
100
101Zed requires a Vulkan 1.3 driver and the following desktop portals:
102
103- `org.freedesktop.portal.FileChooser`
104- `org.freedesktop.portal.OpenURI`
105- `org.freedesktop.portal.Secret` or `org.freedesktop.Secrets`
106
107### Windows
108
109Zed supports the following Windows releases:
110| Version | Zed Status |
111| ------------------------- | ------------------- |
112| Windows 11, version 22H2 and later | Supported |
113| Windows 10, version 1903 and later | Supported |
114
115A 64-bit operating system is required to run Zed.
116
117#### Windows Hardware
118
119Zed supports machines with x64 (Intel, AMD) or Arm64 (Qualcomm) processors that meet the following requirements:
120
121- Graphics: A GPU that supports DirectX 11 (most PCs from 2012+).
122- Driver: Current NVIDIA/AMD/Intel/Qualcomm driver (not the Microsoft Basic Display Adapter).
123
124### FreeBSD
125
126Not yet available as an official download. Can be built [from source](./development/freebsd.md).
127
128### Web
129
130Not supported at this time. See our [Platform Support issue](https://github.com/zed-industries/zed/issues/5391).