uninstall.md

  1---
  2title: Uninstall
  3description: "This guide covers how to uninstall Zed on different operating systems."
  4---
  5
  6# Uninstall
  7
  8This guide covers how to uninstall Zed on different operating systems.
  9
 10## macOS
 11
 12### Standard Installation
 13
 14If you installed Zed by downloading it from the website:
 15
 161. Quit Zed if it's running
 172. Open Finder and go to your Applications folder
 183. Drag Zed to the Trash (or right-click and select "Move to Trash")
 194. Empty the Trash
 20
 21### Homebrew Installation
 22
 23If you installed Zed using Homebrew, use the following command:
 24
 25```sh
 26brew uninstall --cask zed
 27```
 28
 29Or for the preview version:
 30
 31```sh
 32brew uninstall --cask zed@preview
 33```
 34
 35### Removing User Data (Optional)
 36
 37To completely remove all Zed configuration files and data:
 38
 391. Open Finder
 402. Press `Cmd + Shift + G` to open "Go to Folder"
 413. Delete the following directories if they exist:
 42   - `~/Library/Application Support/Zed`
 43   - `~/Library/Saved Application State/dev.zed.Zed.savedState`
 44   - `~/Library/Logs/Zed`
 45   - `~/Library/Caches/dev.zed.Zed`
 46
 47## Linux
 48
 49### Standard Uninstall
 50
 51If Zed was installed using the default installation script, run:
 52
 53```sh
 54zed --uninstall
 55```
 56
 57You'll be prompted whether to keep or delete your preferences. After making a choice, you should see a message that Zed was successfully uninstalled.
 58
 59If the `zed` command is not found in your PATH, try:
 60
 61```sh
 62$HOME/.local/bin/zed --uninstall
 63```
 64
 65or:
 66
 67```sh
 68$HOME/.local/zed.app/bin/zed --uninstall
 69```
 70
 71### Package Manager
 72
 73If you installed Zed using a package manager (such as Flatpak, Snap, or a distribution-specific package manager), consult that package manager's documentation for uninstallation instructions.
 74
 75### Manual Removal
 76
 77If the uninstall command fails or Zed was installed to a custom location, you can manually remove:
 78
 79- Installation directory: `~/.local/zed.app` (or your custom installation path)
 80- Binary symlink: `~/.local/bin/zed`
 81- Configuration and data: `~/.config/zed`
 82
 83## Windows
 84
 85### Standard Installation
 86
 871. Quit Zed if it's running
 882. Open Settings (Windows key + I)
 893. Go to "Apps" > "Installed apps" (or "Apps & features" on Windows 10)
 904. Search for "Zed"
 915. Click the three dots menu next to Zed and select "Uninstall"
 926. Follow the prompts to complete the uninstallation
 93
 94Alternatively, you can:
 95
 961. Open the Start menu
 972. Right-click on Zed
 983. Select "Uninstall"
 99
100### Removing User Data (Optional)
101
102To completely remove all Zed configuration files and data:
103
1041. Press `Windows key + R` to open Run
1052. Type `%APPDATA%` and press Enter
1063. Delete the `Zed` folder if it exists
1074. Press `Windows key + R` again, type `%LOCALAPPDATA%` and press Enter
1085. Delete the `Zed` folder if it exists
109
110## Troubleshooting
111
112If you encounter issues during uninstallation:
113
114- **macOS/Windows**: Ensure Zed is completely quit before attempting to uninstall. Check Activity Manager (macOS) or Task Manager (Windows) for any running Zed processes.
115- **Linux**: If the uninstall script fails, check the error message and consider manual removal of the directories listed above.
116- **All platforms**: If you want to start fresh while keeping Zed installed, you can delete the configuration directories instead of uninstalling the application entirely.
117
118For additional help, see our [Linux-specific documentation](./linux.md) or visit the [Zed community](https://zed.dev/community-links).