We provide pre-built binaries on the GitHub Releases page.
Helix is available in homebrew-core:
brew install helix
A flake containing the package is available in
the project root. The flake can also be used to spin up a reproducible development
shell for working on Helix with
Flake outputs are cached for each push to master using Cachix. The flake is configured to automatically make use of this cache assuming the user accepts the new settings on first use.
If you are using a version of Nix without flakes enabled you can
install Cachix cli;
cachix use helix will
configure Nix to use cached outputs when possible.
Releases are available in the
A helix-git package is also available on the AUR, which builds the master branch.
You can install the COPR package for Helix via
sudo dnf copr enable varlad/helix sudo dnf install helix
sudo xbps-install helix
scoop install helix
choco install helix
Choose the proper command for your system from below:
- For 32 bit Windows 7 or above:
pacman -S mingw-w64-i686-helix
- For 64 bit Windows 7 or above:
pacman -S mingw-w64-x86_64-helix
- For 64 bit Windows 8.1 or above:
pacman -S mingw-w64-ucrt-x86_64-helix
git clone https://github.com/helix-editor/helix cd helix cargo install --path helix-term --locked
This will install the
hx binary to
$HOME/.cargo/bin and build tree-sitter grammars in
If you are using the musl-libc instead of glibc the following environment variable must be set during the build to ensure tree sitter grammars can be loaded correctly:
Helix also needs its runtime files so make sure to copy/symlink the
runtime/ directory into the
config directory (for example
~/.config/helix/runtime on Linux/macOS). This location can be overridden
HELIX_RUNTIME environment variable.
|Linux / macOS|
Starting with Windows Vista you can also create symbolic links on Windows. Note that this requires elevated privileges - i.e. PowerShell or Cmd must be run as administrator.
New-Item -ItemType SymbolicLink -Target "runtime" -Path "$Env:AppData\helix\runtime"
cd %appdata%\helix mklink /D runtime "<helix-repo>\runtime"
The runtime location can be overridden via the
HELIX_RUNTIME environment variable.
HELIX_RUNTIMEis set prior to calling
cargo install --path helix-term --locked, tree-sitter grammars will be built in
If you plan on keeping the repo locally, an alternative to copying/symlinking
runtime files is to set
HELIX_RUNTIME=$PWD/runtime if you're in the helix repo directory).
To use Helix in desktop environments that supports XDG desktop menu, including Gnome and KDE, copy the provided
.desktop file to the correct folder:
cp contrib/Helix.desktop ~/.local/share/applications
To use another terminal than the default, you will need to modify the
.desktop file. For example, to use
sed -i "s|Exec=hx %F|Exec=kitty hx %F|g" ~/.local/share/applications/Helix.desktop sed -i "s|Terminal=true|Terminal=false|g" ~/.local/share/applications/Helix.desktop
Please note: there is no icon for Helix yet, so the system default will be used.
To make sure everything is set up as expected you should finally run the helix healthcheck via
For more information on the information displayed in the health check results refer to Healthcheck.
Tree-sitter grammars must be fetched and compiled if not pre-packaged.
Fetch grammars with
hx --grammar fetch (requires
git) and compile them
hx --grammar build (requires a C++ compiler).
Language servers can optionally be installed if you want their features (auto-complete, diagnostics etc.). Follow the instructions on the wiki page to add your language servers of choice.