elan
github.com
- Free plan
- Windows
- macOS
- Linux
What elan is
elan manages installations of the Lean theorem prover on Linux, macOS and Windows. Its `lean` and `lake` commands select the Lean version specified in a project’s `lean-toolchain` file and download it when needed. The `elan` command also lets users install, select, run and uninstall Lean versions manually. The project supports version pinning, lockfiles, automatic switching, shell integration and CI/CD use. Installation instructions include shell methods for Linux and macOS, PowerShell for Windows, and downloads for supported platforms. On NixOS, the README recommends the Nixpkgs version because toolchains downloaded by elan need patching there. Lake needs git to download dependencies. The project describes elan as a fork of rustup adapted for Lean infrastructure. It is free under Apache-2.0 and MIT licenses, and the releases page identifies v4.2.4 as the latest release. The README also says elan’s self-uninstall command should remove elan and revert shell configuration changes made during installation.
Who it suits
elan suits Lean users who want toolchains selected per project or managed manually. It is relevant to developers working across Linux, macOS or Windows, including CI/CD use.
Good to know, and what to watch
- Selects toolchain versions from a project file.
- Can install, select, run and uninstall Lean versions.
- Supports pinning, lockfiles and automatic switching.
- Installation methods are listed for Linux, macOS and Windows.
- Free under Apache-2.0 and MIT licenses.
- Lake needs git to download dependencies.
- Downloaded toolchains need patching on NixOS.
- The README recommends the Nixpkgs version on NixOS.
Plans
Every plan and priceelan
Free plan
Getting started
- Open the elan GitHub repository
- Run the shell installer on Linux or macOS
- Run the PowerShell installer on Windows
- Use a release download for a supported platform
- Ensure git is installed when Lake must download dependencies
- Place a Lean version in the project’s lean-toolchain file
The verdict
elan handles Lean toolchain selection per project as well as manual version management. On NixOS, follow the project’s Nixpkgs recommendation, and ensure git is available for Lake dependency downloads.
Questions people ask
What does elan manage?
elan manages installations and versions of the Lean theorem prover. Its commands can install, select, run, and uninstall Lean versions.
Is elan free?
Yes. The listed elan plan costs nothing, and the repository lists Apache-2.0 and MIT licenses.
Which operating systems are supported?
elan supports Linux, macOS, and Windows.
How does automatic version selection work?
The `lean` and `lake` binaries read a project’s `lean-toolchain` file and select or download the specified Lean version.
Does elan work with CI/CD?
Yes. CI/CD usage is listed among its supported capabilities, along with project version pinning, lockfiles, and shell integration.
What does uninstall do?
The `elan self uninstall` command removes elan and reverts shell configuration changes made during installation.
What the maker publishes
- Automatic toolchain selection
- Its lean and lake binaries select and, when necessary, download the Lean version specified in a project's lean-toolchain file. source
- Dependency
- The README says git is needed for Lake to download dependencies. source
- Install methods
- The README provides shell installation for Linux and macOS, PowerShell installation for Windows, and release downloads for supported platforms. source
- Latest release
- The GitHub releases page identifies v4.2.4 as the latest release. source
- License
- The repository lists Apache-2.0 and MIT licenses. source
- Manual toolchain management
- The elan executable can install, select, run, and uninstall Lean versions manually. source
- NixOS
- The README recommends installing the Nixpkgs version because elan-downloaded toolchains require patching on NixOS. source
- Project lineage
- The README describes elan as basically a fork of rustup adapted for Lean infrastructure. source
- Purpose
- elan manages installations of the Lean theorem prover. source
- Uninstallation
- The README says elan self uninstall should remove elan and revert the shell configuration changes made during installation. source
Checked against the maker's pages on 28 Sept 2026.