Skip to main content

​
Installing Zed

Zed is available for macOS, Linux, and Windows. Choose your platform below to get started.

​
macOS

​
Direct Download

Download the latest stable build from the Zed download page. The download is a .dmg file—open it and drag Zed to your Applications folder. For the preview build, which receives updates about a week ahead of stable, visit the preview releases page. After installation, Zed automatically checks for updates and prompts you when a new version is available.

​
Homebrew

Install Zed using Homebrew: 
brew install --cask zed

​
System Requirements

Zed supports the following macOS releases:
VersionCodenameApple StatusZed Status
macOS 26.xTahoeSupportedSupported
macOS 15.xSequoiaSupportedSupported
macOS 14.xSonomaSupportedSupported
macOS 13.xVenturaSupportedSupported
macOS 12.xMontereyEOL 2024-09-16Supported
macOS 11.xBig SurEOL 2023-09-26Partially Supported
macOS 10.15.xCatalinaEOL 2022-09-12Partially Supported
macOS Big Sur and Catalina do not support screen sharing via Zed Collaboration. These features require ScreenCaptureKit, available only on macOS 12 (Monterey) and newer.

​
Mac Hardware

Zed supports machines with Intel (x86_64) or Apple Silicon (aarch64) processors:
  • MacBook Pro (Early 2015 and newer)
  • MacBook Air (Early 2015 and newer)
  • MacBook (Early 2016 and newer)
  • Mac Mini (Late 2014 and newer)
  • Mac Pro (Late 2013 or newer)
  • iMac (Late 2015 and newer)
  • iMac Pro (all models)
  • Mac Studio (all models)

​
Linux

The fastest way to install Zed on Linux is using the official installation script: 
curl -f https://zed.dev/install.sh | sh
This script supports x86_64 and aarch64 architectures on Ubuntu, Arch, Debian, RedHat, CentOS, Fedora, and more.

​
Install a Specific Version

You can specify a version using the ZED_VERSION environment variable: 
# Install a specific version
curl -f https://zed.dev/install.sh | ZED_VERSION=0.216.0 sh

​
Install Preview Build

To install the preview build: 
curl -f https://zed.dev/install.sh | ZED_CHANNEL=preview sh

​
Package Managers

Zed is available through several package managers: 
sudo pacman -S zed
Third-party packages may not be completely up to date and may use different binary names (like zedit or zeditor).
See Repology for a complete list of Zed packages across distributions.

​
Manual Download

Download the pre-built .tar.gz file for your architecture: Extract and create a symlink: 
mkdir -p ~/.local
# Extract zed to ~/.local/zed.app/
tar -xvf <path/to/download>.tar.gz -C ~/.local
# Link the zed binary to ~/.local/bin
ln -sf ~/.local/zed.app/bin/zed ~/.local/bin/zed
For desktop integration, install the .desktop file: 
install -D ~/.local/zed.app/share/applications/dev.zed.Zed.desktop -t ~/.local/share/applications
sed -i "s|Icon=zed|Icon=$HOME/.local/zed.app/share/icons/hicolor/512x512/apps/zed.png|g" ~/.local/share/applications/dev.zed.Zed.desktop
sed -i "s|Exec=zed|Exec=$HOME/.local/zed.app/bin/zed|g" ~/.local/share/applications/dev.zed.Zed.desktop

​
System Requirements

  • 64-bit Intel/AMD (x86_64) or 64-bit Arm (aarch64) processor
  • Vulkan 1.3 driver
  • The following desktop portals:
    • org.freedesktop.portal.FileChooser
    • org.freedesktop.portal.OpenURI
    • org.freedesktop.portal.Secret or org.freedesktop.Secrets

​
Windows

​
Direct Download

Download the latest stable build from the Zed download page. Run the installer and follow the setup wizard. For the preview build, visit the preview releases page.

​
Windows Package Manager (winget)

Install Zed using winget: 
winget install -e --id ZedIndustries.Zed

​
System Requirements

VersionZed Status
Windows 11, version 22H2 and laterSupported
Windows 10, version 1903 and laterSupported
A 64-bit operating system is required to run Zed.

​
Windows Hardware

Zed supports machines with x64 (Intel, AMD) or Arm64 (Qualcomm) processors:
  • Graphics: GPU that supports DirectX 11 (most PCs from 2012+)
  • Driver: Current NVIDIA/AMD/Intel/Qualcomm driver (not Microsoft Basic Display Adapter)

​
Installing the CLI

Zed includes a command-line tool for opening files and projects from the terminal.
1

Open Zed

Launch the Zed application.
2

Open Command Palette

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Linux/Windows).
3

Run 'cli: install'

Search for and run the cli: install command.
This creates a zed command that you can use from any terminal: 
zed .                    # Open current folder
zed file.txt             # Open a file
zed project/ file.txt    # Open a folder and a file
On Linux and Windows, the CLI is automatically included with Zed packages. The binary name may vary by distribution.

​
Verifying Installation

Check that Zed is installed correctly: 
zed --version
You should see output like: 
zed 0.216.0

​
Next Steps

Now that you have Zed installed, head to the Quick Start guide to learn the essentials and start coding.

Quick Start Guide

Get up to speed with Zed’s essential features and commands

​
Troubleshooting

​
macOS: “Zed is damaged” Warning

If macOS reports that Zed is damaged, try:
  1. Right-click on Zed in Applications
  2. Select “Open” from the context menu
  3. Click “Open” in the dialog
Or remove the quarantine attribute: 
xattr -cr /Applications/Zed.app

​
Linux: Graphics Issues

If Zed fails to start with a NoSupportedDeviceFound error, verify Vulkan support: 
vkcube
If this doesn’t work, install Vulkan-compatible GPU drivers. See the Arch Vulkan guide for troubleshooting steps.

​
Windows: Blank Window

Ensure your GPU drivers are up to date:
  1. Visit your GPU manufacturer’s website (NVIDIA, AMD, Intel, or Qualcomm)
  2. Download and install the latest drivers
  3. Restart your computer and try launching Zed again
For more help, see the full Troubleshooting guide.