Skip to content

Install L

Check GitHub Releases for published binaries, or use the source-build fallback. The commands below pin v0.0.1 and become available when that release is published.

Building L programs needs native C/linker tools: use Xcode Command Line Tools on macOS or your Linux distribution's development tools. Initial setup requires internet access. The binary installer can prepare rustup, Rust 1.98.1 and the locked dependencies; L invokes cargo +1.98.1, so standalone Cargo is insufficient.

Native builds target the current host. Running a published L program requires neither L nor Go/Rust toolchains.

Download the versioned installer for Apple Silicon macOS (ARM64) or Linux (ARM64 and x86-64). Releases do not currently support Intel macOS; contributions toward future support are welcome.

Terminal window
curl --fail --location --proto '=https' --tlsv1.2 \
https://github.com/l-programming-language/l/releases/download/v0.0.1/install-release.sh \
--output install-release.sh

Inspect the script, then run it:

Terminal window
bash ./install-release.sh --version 0.0.1 --with-toolchain
export PATH="$HOME/.local/bin:$HOME/.cargo/bin:$PATH"
l --version

The installer selects the host archive, verifies its SHA-256 checksum, prepares dependencies, and installs l into ~/.local/bin. Language resources are embedded; binary installation needs no Go or compiler source checkout. Add the PATH export to your shell configuration. The installer never edits profiles, uses sudo, or invokes a system package manager.

OptionEffect
--with-toolchainPermit installing missing Rust tools. Otherwise interactive setup asks; noninteractive setup requires them to exist.
--binary-onlyInstall only l, deferring native prerequisites.
--prefix DIRECTORYChoose the executable directory.
--version VERSIONPin a release; omission selects the latest normal release once for all assets.
--repository OWNER/REPOIntentionally select another repository's release.

Setup fetches locked dependencies and verifies frozen resolution without changing the default Rust toolchain. For a manually extracted archive, run bash setup-release.sh --with-toolchain with its setup files still alongside it.

Upgrades replace the binary only after verification and requested setup succeed; failure preserves the existing installation. Read the compatibility policy before upgrading.

macOS releases below v1.0.0 have no Developer ID signature or Apple notarization. macOS may block them or require approval, depending on download method and security settings. Follow Apple's guidance only after checking that you trust the source. Production macOS releases require signing and notarization from v1.0.0 onward.

After dependency setup, build your first program. The walkthrough covers saving a source file, compiling it, and running the result without a compiler source checkout.

Source installation also needs Git and Go 1.27.3, pinned in .go-version.

Terminal window
git clone https://github.com/l-programming-language/l.git
cd l
bash ./install.sh
export PATH="$PWD/bin:$PATH"
l --version

Check out the release's tag before building when you need a specific version. install.sh verifies Go dependencies and builds the self-contained bin/l with -mod=readonly; it does not prepare Rust.

For source installation, run CGO_ENABLED=1 scripts/l-ci bootstrap from the matching checkout to download pinned tools and locked dependencies and compile their caches. This can take several minutes; see the development policy.

L's native compilation uses frozen, offline Cargo resolution. Installing Rust alone does not populate its dependency cache; preserve the retained locks rather than removing --frozen.


Canonical source: docs/cli/installation.md.