windows.md

 1# Zed on Windows
 2
 3## Installing Zed
 4
 5Get 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.
 6
 7You can also build zed from source, see [these docs](https://zed.dev/docs/development/windows) for instructions.
 8
 9## Uninstall
10
11- Installed via installer: Use `Settings``Apps``Installed apps`, search for Zed, and click Uninstall.
12- Built from source: Remove the build output directory you created (e.g., your target/install folder).
13
14Your settings and extensions live in your user profile. When uninstalling, you can choose to keep or remove them.
15
16## Remote Development (SSH)
17
18Zed supports remote development on Windows through both SSH and WSL. You can connect to remote servers via SSH or work with files inside WSL distributions directly from Zed.
19
20For detailed instructions on setting up and using remote development features, including SSH configuration, WSL setup, and troubleshooting, see the [Remote Development documentation](./remote-development.md).
21
22## Troubleshooting
23
24### Zed fails to start or shows a blank window
25
26- Update your GPU drivers from your GPU vendor (Intel/AMD/NVIDIA).
27- Ensure hardware acceleration is enabled in Windows and not blocked by third‑party software.
28- Try launching Zed with no extensions or custom settings to isolate conflicts.
29
30### Terminal issues
31
32If activation scripts don’t run, update to the latest version and verify your shell profile files are not exiting early. For Git operations, confirm Git Bash or PowerShell is available and on PATH.
33
34### SSH remoting problems
35
36When prompted for credentials, use the graphical askpass dialog. If it doesn’t appear, check for credential manager conflicts and that GUI prompts aren’t blocked by your terminal.
37
38### Graphics issues
39
40#### Zed fails to open / degraded performance
41
42Zed requires a DX11 compatible GPU to run, if Zed doesn't open for you it is possible that your GPU does not meet the minimum requirements.
43
44To check if your GPU supports DX11, you can use the following command:
45
46```
47dxdiag
48```
49
50Which will open the diagnostic tool that will show the minimum DirectX version your GPU supports under `System``System Information``DirectX Version`.
51
52You might also be trying to run Zed inside a virtual machine in which case it will use the emulated adapter that your VM provides, while Zed will work the performance will be degraded.