1# Uninstall
  2
  3This guide covers how to uninstall Zed on different operating systems.
  4
  5## macOS
  6
  7### Standard Installation
  8
  9If you installed Zed by downloading it from the website:
 10
 111. Quit Zed if it's running
 122. Open Finder and go to your Applications folder
 133. Drag Zed to the Trash (or right-click and select "Move to Trash")
 144. Empty the Trash
 15
 16### Homebrew Installation
 17
 18If you installed Zed using Homebrew, use the following command:
 19
 20```sh
 21brew uninstall --cask zed
 22```
 23
 24Or for the preview version:
 25
 26```sh
 27brew uninstall --cask zed@preview
 28```
 29
 30### Removing User Data (Optional)
 31
 32To completely remove all Zed configuration files and data:
 33
 341. Open Finder
 352. Press `Cmd + Shift + G` to open "Go to Folder"
 363. Delete the following directories if they exist:
 37   - `~/Library/Application Support/Zed`
 38   - `~/Library/Saved Application State/dev.zed.Zed.savedState`
 39   - `~/Library/Logs/Zed`
 40   - `~/Library/Caches/dev.zed.Zed`
 41
 42## Linux
 43
 44### Standard Uninstall
 45
 46If Zed was installed using the default installation script, run:
 47
 48```sh
 49zed --uninstall
 50```
 51
 52You'll be prompted whether to keep or delete your preferences. After making a choice, you should see a message that Zed was successfully uninstalled.
 53
 54If the `zed` command is not found in your PATH, try:
 55
 56```sh
 57$HOME/.local/bin/zed --uninstall
 58```
 59
 60or:
 61
 62```sh
 63$HOME/.local/zed.app/bin/zed --uninstall
 64```
 65
 66### Package Manager
 67
 68If 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.
 69
 70### Manual Removal
 71
 72If the uninstall command fails or Zed was installed to a custom location, you can manually remove:
 73
 74- Installation directory: `~/.local/zed.app` (or your custom installation path)
 75- Binary symlink: `~/.local/bin/zed`
 76- Configuration and data: `~/.config/zed`
 77
 78## Windows
 79
 80### Standard Installation
 81
 821. Quit Zed if it's running
 832. Open Settings (Windows key + I)
 843. Go to "Apps" > "Installed apps" (or "Apps & features" on Windows 10)
 854. Search for "Zed"
 865. Click the three dots menu next to Zed and select "Uninstall"
 876. Follow the prompts to complete the uninstallation
 88
 89Alternatively, you can:
 90
 911. Open the Start menu
 922. Right-click on Zed
 933. Select "Uninstall"
 94
 95### Removing User Data (Optional)
 96
 97To completely remove all Zed configuration files and data:
 98
 991. Press `Windows key + R` to open Run
1002. Type `%APPDATA%` and press Enter
1013. Delete the `Zed` folder if it exists
1024. Press `Windows key + R` again, type `%LOCALAPPDATA%` and press Enter
1035. Delete the `Zed` folder if it exists
104
105## Troubleshooting
106
107If you encounter issues during uninstallation:
108
109- **macOS/Windows**: Ensure Zed is completely quit before attempting to uninstall. Check Activity Manager (macOS) or Task Manager (Windows) for any running Zed processes.
110- **Linux**: If the uninstall script fails, check the error message and consider manual removal of the directories listed above.
111- **All platforms**: If you want to start fresh while keeping Zed installed, you can delete the configuration directories instead of uninstalling the application entirely.
112
113For additional help, see our [Linux-specific documentation](./linux.md) or visit the [Zed community](https://zed.dev/community).