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   - `~/Library/Caches/Zed`
 47   - `~/.config/zed`
 48   - `~/.local/state/Zed`
 49
 50## Linux
 51
 52### Standard Uninstall
 53
 54If Zed was installed using the default installation script, run:
 55
 56```sh
 57zed --uninstall
 58```
 59
 60You'll be prompted whether to keep or delete your preferences. After making a choice, you should see a message that Zed was successfully uninstalled.
 61
 62If the `zed` command is not found in your PATH, try:
 63
 64```sh
 65$HOME/.local/bin/zed --uninstall
 66```
 67
 68or:
 69
 70```sh
 71$HOME/.local/zed.app/bin/zed --uninstall
 72```
 73
 74### Package Manager
 75
 76If 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.
 77
 78### Manual Removal
 79
 80If the uninstall command fails or Zed was installed to a custom location, you can manually remove:
 81
 82- Installation directory: `~/.local/zed.app` (or your custom installation path)
 83- Binary symlink: `~/.local/bin/zed`
 84- Configuration and data: `~/.config/zed`
 85
 86## Windows
 87
 88### Standard Installation
 89
 901. Quit Zed if it's running
 912. Open Settings (Windows key + I)
 923. Go to "Apps" > "Installed apps" (or "Apps & features" on Windows 10)
 934. Search for "Zed"
 945. Click the three dots menu next to Zed and select "Uninstall"
 956. Follow the prompts to complete the uninstallation
 96
 97Alternatively, you can:
 98
 991. Open the Start menu
1002. Right-click on Zed
1013. Select "Uninstall"
102
103### Removing User Data (Optional)
104
105To completely remove all Zed configuration files and data:
106
1071. Press `Windows key + R` to open Run
1082. Type `%APPDATA%` and press Enter
1093. Delete the `Zed` folder if it exists
1104. Press `Windows key + R` again, type `%LOCALAPPDATA%` and press Enter
1115. Delete the `Zed` folder if it exists
112
113## Troubleshooting
114
115If you encounter issues during uninstallation:
116
117- **macOS/Windows**: Ensure Zed is completely quit before attempting to uninstall. Check Activity Manager (macOS) or Task Manager (Windows) for any running Zed processes.
118- **Linux**: If the uninstall script fails, check the error message and consider manual removal of the directories listed above.
119- **All platforms**: If you want to start fresh while keeping Zed installed, you can delete the configuration directories instead of uninstalling the application entirely.
120
121For additional help, see our [Linux-specific documentation](./linux.md) or visit the [Zed community](https://zed.dev/community-links).