Tjswysqh: Created page with "Zed"

2026-08-07T00:30:49Z

Created page with "Zed"

New page

<languages/>
{{infobox application
|name=Zed
|image=Zed_Editor_Logo.png
|type=Source-code Editor
|developer=Zed Industries
|predecessor=Atom
|status=Active
|license=[https://www.gnu.org/licenses/agpl-3.0.html AGPL], [https://www.gnu.org/licenses/gpl-3.0.html GPL], [https://www.apache.org/licenses/LICENSE-2.0 Apache License]
|os=Cross-platform (Linux, macOS, Windows)
|platform=Desktop
|programmingLanguage=Rust
|website=[https://zed.dev zed.dev]
|github=zed-industries/zed
|bugTracker=[https://github.com/zed-industries/zed/issues GitHub Issues]
|documentation=[https://zed.dev/docs Zed Documentation]
}}
<div lang="en" dir="ltr" class="mw-content-ltr">
[https://zed.dev Zed]<ref>Zed Industries, "Zed", Official Website, Accessed October 2025. https://zed.dev</ref> is a collaborative, GPU-accelerated text editor developed by Zed Industries. It combines fast local editing with real-time multiplayer features and ships with batteries-included tooling for popular programming languages.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The editor provides native builds for Linux, including Nixpkgs packages and a reproducible flake. Hardware acceleration requires a GPU with Vulkan support; systems without Vulkan can fall back to emulation via tools such as [https://github.com/nix-community/nixGL nixGL].<ref>Zed Industries, "Linux", Zed Documentation, Accessed October 2025. https://zed.dev/docs/linux</ref>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
{{Nixpkg|pkgs/by-name/ze/zed-editor|zed-editor}} is available in Nixpkgs since 24.11; However, Zed provides [https://github.com/zed-industries/zed/blob/main/flake.nix an official nix flake] which might be useful if you need features that have not yet reached unstable Nixpkgs.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Installation ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The package installs both desktop launchers and a CLI entry point aliased to <code>zeditor</code>, mirroring the upstream binary name
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Imperative ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== Zed's Flake ====
</div>

<syntaxhighlight lang="console">
nix run github:zed-industries/zed
</syntaxhighlight>

==== Nixpkgs ====

<syntaxhighlight lang="console">
nix run nixpkgs#zed-editor
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Declarative ===
</div>

==== NixOS ====

<syntaxhighlight lang="nix">
environment.systemPackages = [
pkgs.zed-editor
];
</syntaxhighlight>

{{Evaluate}}
==== Home Manager ====

<syntaxhighlight lang="nix">
home.packages = [
pkgs.zed-editor
];
</syntaxhighlight>

<syntaxhighlight lang="console">
home-manager switch
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== Zed's Flake ====
</div>

<syntaxhighlight lang="nix">
{
inputs.zed.url = "github:zed-industries/zed";

outputs =
{
self,
nixpkgs,
zed,
...
}@inputs:
let
system = "x86_64-linux";
pkgs = import nixpkgs { inherit system; };
in
{
packages.${system}.zed-latest = zed.packages.${system}.default;
};
}
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
Build the flake package with <code>nix build .#zed-latest</code> or expose it in your configuration with the appropriate overlay.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
{{Warning|Zed requires hardware-accelerated Vulkan. On systems without supported drivers, use <code>nixGL</code> or home-manager's <code>nixGL.vulkan.enable {{=}} true;</code> to provide the necessary libraries.
Providing Vulkan through <code>nixGL</code> can be more consistent than relying on host distribution packages, especially on non-NixOS systems where Wayland and X11 stacks differ in their Vulkan capabilities.}}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Configuration ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Zed stores its configuration in JSON files under <code>~/.config/zed</code>. Home Manager can manage these settings declaratively.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== Basic ====
</div>

<syntaxhighlight lang="nix">
programs.zed-editor = {
enable = true;
extensions = [ "nix" "toml" "rust" ];
userSettings = {
theme = {
mode = "system";
dark = "One Dark";
light = "One Light";
};
hour_format = "hour24";
vim_mode = true;
};
};
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
The configuration above enables Zed via Home Manager, installs a small set of extensions, and synchronises the theme with the desktop appearance.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== Advanced ====
</div>

<syntaxhighlight lang="nix">
programs.zed-editor = {
enable = true;

# This populates the userSettings "auto_install_extensions"
extensions = [ "nix" "toml" "elixir" "make" ];

# Everything inside of these brackets are Zed options
userSettings = {
assistant = {
enabled = true;
version = "2";
default_open_ai_model = null;

# Provider options:
# - zed.dev models (claude-3-5-sonnet-latest) requires GitHub connected
# - anthropic models (claude-3-5-sonnet-latest, claude-3-haiku-latest, claude-3-opus-latest) requires API_KEY
# - copilot_chat models (gpt-4o, gpt-4, gpt-3.5-turbo, o1-preview) requires GitHub connected
default_model = {
provider = "zed.dev";
model = "claude-3-5-sonnet-latest";
};

# inline_alternatives = [
# {
# provider = "copilot_chat";
# model = "gpt-3.5-turbo";
# }
# ];
};

node = {
path = lib.getExe pkgs.nodejs;
npm_path = lib.getExe' pkgs.nodejs "npm";
};

hour_format = "hour24";
auto_update = false;

terminal = {
alternate_scroll = "off";
blinking = "off";
copy_on_select = false;
dock = "bottom";
detect_venv = {
on = {
directories = [ ".env" "env" ".venv" "venv" ];
activate_script = "default";
};
};
env = {
TERM = "alacritty";
};
font_family = "FiraCode Nerd Font";
font_features = null;
font_size = null;
line_height = "comfortable";
option_as_meta = false;
button = false;
shell = "system";
# shell = {
# program = "zsh";
# };
toolbar = {
title = true;
};
working_directory = "current_project_directory";
};

lsp = {
rust-analyzer = {
binary = {
# path = lib.getExe pkgs.rust-analyzer;
path_lookup = true;
};
};

nix = {
binary = {
path_lookup = true;
};
};

elixir-ls = {
binary = {
path_lookup = true;
};
settings = {
dialyzerEnabled = true;
};
};
};

languages = {
"Elixir" = {
language_servers = [ "!lexical" "elixir-ls" "!next-ls" ];
format_on_save = {
external = {
command = "mix";
arguments = [ "format" "--stdin-filename" "{buffer_path}" "-" ];
};
};
};

"HEEX" = {
language_servers = [ "!lexical" "elixir-ls" "!next-ls" ];
format_on_save = {
external = {
command = "mix";
arguments = [ "format" "--stdin-filename" "{buffer_path}" "-" ];
};
};
};
};

vim_mode = true;

# Tell Zed to use direnv and direnv can use a flake.nix environment
load_direnv = "shell_hook";
base_keymap = "VSCode";

theme = {
mode = "system";
light = "One Light";
dark = "One Dark";
};

show_whitespaces = "all";
ui_font_size = 16;
buffer_font_size = 16;
};
};
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
This example adds language servers to the FHS sandbox, enables the bundled assistant, configures the terminal, and ensures remote server binaries are provided declaratively.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The <code>userSettings</code> and <code>userKeyMaps</code> options translate directly into JSON. The <code>extraPackages</code> option includes additional Nixpkgs in the FHS environment, useful for LSP servers (e.g., <code>pkgs.nixd</code>) or optional tools (e.g., <code>pkgs.shellcheck</code> for the Basher LSP).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Home Manager renders <code>settings.json</code> as read-only, which prevents Zed's GUI from saving most preference changes, including AI provider selection. Plan to manage long-term settings declaratively or temporarily disable the module when editing interactively.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Only the initial extension list can be defined declaratively; additional extensions installed through the GUI are stored within Zed's writable data directories and do not appear in <code>userSettings</code>. This follows a similar model to VSCode, where extensions require external binaries downloaded at runtime.
</div>

== LSP support ==
<div lang="en" dir="ltr" class="mw-content-ltr">
Zed downloads LSP servers into <code>~/.local/share/zed/languages/</code>. These binaries most likely will not work because of linking issues. You can workaround this with the following methods or bring your own LSP servers.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
Check <strong>LSP Logs → Server Info</strong> to confirm which binaries are running.
</div>

==== Nix-ld (recommended) ====
<div lang="en" dir="ltr" class="mw-content-ltr">
Enable [[FAQ#I've downloaded a binary, but I can't run it, what can I do?|<code>programs.nix-ld</code>]] so language servers downloaded by Zed can resolve dynamic libraries without wrapping and work out of the box.
</div>

==== FHS wrapper ====
<div lang="en" dir="ltr" class="mw-content-ltr">
Use <code>pkgs.zed-editor.fhsWithPackages</code> to extend the FHS environment with additional system libraries when a language server requires them.
</div>

<syntaxhighlight lang="nix">
pkgs.zed-editor.fhsWithPackages(
pkgs: with pkgs; [
openssl
zlib
]
)
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
Remember that language servers started inside the wrapper do not inherit tools and libraries from nix shell. This is usually not desired because LSP may need project-level dependencies provided by nix-shell to compile and analyze the code.
</div>

==== Bring your own LSP servers ====
<div lang="en" dir="ltr" class="mw-content-ltr">
Newer versions of Zed can detect LSP servers installed in <code>PATH</code> and prefer local versions over automatically downloaded ones. Install LSP servers globally or provide them through nix shell.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
Nixpkgs versions of tools may be required for development on NixOS, especially for the C/C++ ecosystem. Check <strong>LSP Logs → Server Info</strong> to see which binaries are running.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
If automatic detection doesn't work, specify the path manually in your Zed configuration:
</div>

<syntaxhighlight lang="json">
{
"lsp": {
"rust-analyzer": {
"binary": {
"path": "/run/current-system/sw/bin/rust-analyzer"
}
}
}
}
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
Adjust the path for each language server you manage. The example above assumes rust-analyzer is installed in your system profile.
</div>

== Remote server ==
<div lang="en" dir="ltr" class="mw-content-ltr">
Zed uploads a versioned remote server binary to <code>~/.zed_server</code> on the target host. The Nixpkgs package exposes the matching binary via the <code>remote_server</code> output.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
When you connect to a remote machine, the client either downloads a matching server binary from upstream or pushes a local copy if <code>"upload_binary_over_ssh": true</code> is enabled. Connections fail if the versions diverge.
</div>

<syntaxhighlight lang="nix">
home.file.".zed_server" = {
source = "${pkgs.zed-editor.remote_server}/bin";
recursive = true;
};
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
The <code>recursive = true;</code> setting keeps the directory writable while symlinking individual binaries, allowing Zed to add new versions when needed. This is necessary because the <code>~/.zed_server</code> folder is also used when external clients connect to the current system as a remote.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
Alternatively, use Home Manager's built-in option for simpler setup:
</div>

<syntaxhighlight lang="nix">programs.zed-editor = {
enable = true;
installRemoteServer = true;
};</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
To restrict remote clients to a specific server version, set <code>recursive = false;</code> to make the entire folder read-only. Zed refuses to connect if it cannot provision the required binary, so document the restriction for collaborators.
</div>

== Tips and tricks ==

==== Vulkan diagnostics ====
{{code|lang=bash|line=no|1=$ vulkaninfo --summary}}
<div lang="en" dir="ltr" class="mw-content-ltr">
Run the command above to check your Vulkan support before launching Zed. Install <code>vulkan-tools</code> if the command is not available. On non-NixOS systems, you may need to wrap Zed with <code>nixGLVulkan</code> from the nixGL package.
</div>

==== Preinstall extensions ====
<syntaxhighlight lang="json">
{
"extensions": [
"nix",
"toml",
"elixir"
]
}
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
Declaratively listing extensions ensures they are installed automatically on new systems while still allowing additional extensions to be added interactively.
</div>

==== Synchronise settings across machines ====
<div lang="en" dir="ltr" class="mw-content-ltr">
Store the entire <code>~/.config/zed</code> directory in a version-controlled dotfiles repo or manage it with Home Manager to keep settings consistent across hosts.
</div>

== Troubleshooting ==

==== Zed fails to start without Vulkan ====
<div lang="en" dir="ltr" class="mw-content-ltr">
If the GUI refuses to launch, confirm that <code>vulkan-tools</code> reports a working ICD. Use <code>nixGL</code> or vendor packages that supply Vulkan drivers for your GPU.
</div>

==== Remote collaboration disconnects ====
<div lang="en" dir="ltr" class="mw-content-ltr">
Ensure the remote server binary matches the client version. Re-run <code>home-manager switch</code> or update the symlink in <code>~/.zed_server</code> if the versions diverge after an update.
</div>

==== Language server missing binaries ====
<div lang="en" dir="ltr" class="mw-content-ltr">
When Zed reports missing tools, add the required executables to <code>programs.zed-editor.extraPackages</code> or wrap the server using <code>pkgs.writeShellApplication</code>.
</div>

== See also ==
* <div lang="en" dir="ltr" class="mw-content-ltr">
[[Home Manager]] – Manage Zed configuration declaratively
</div>
* <div lang="en" dir="ltr" class="mw-content-ltr">
[[Graphics#Vulkan]] – Set up Vulkan on NixOS systems
</div>
* <div lang="en" dir="ltr" class="mw-content-ltr">
[https://search.nixos.org/options?query=zed-editor NixOS options search for Zed]
</div>

== References ==
<references/>

[[Category:Applications]]
[[Category:Text Editor]]

Zed/zh-cn - Revision history

Tjswysqh: Created page with "Zed"