Installation and first run

August 20, 2026 ยท View on GitHub

This guide covers supported installation methods, upgrading, and the first-run configuration flow. For everyday commands, continue with Views and display or the command reference.

Install with the script

curl -sSL https://raw.githubusercontent.com/chaqchase/lla/main/install.sh | bash

The script detects the operating system and architecture, downloads the matching release binary, verifies it against the release checksum, and installs it in /usr/local/bin.

On Windows PowerShell, use the native installer:

irm https://raw.githubusercontent.com/chaqchase/lla/main/install.ps1 | iex

It detects AMD64 or ARM64, verifies SHA256SUMS, installs to %LOCALAPPDATA%\Programs\lla, and adds that directory to the user PATH. Download install.ps1 first to use its -Version, -InstallDir, or -NoPathUpdate options.

Install with a package manager

PlatformCommand
Cargocargo install lla
macOS with Homebrewbrew install lla
Arch Linux with paruparu -S lla
NetBSD with pkginpkgin install lla
X-CMDx install lla

Install a release manually

Download the release asset that matches the operating system and architecture from GitHub Releases, then make it executable and place it on PATH:

wget -c https://github.com/chaqchase/lla/releases/download/<version>/<asset> -O lla
chmod +x lla
sudo chown root:root lla
sudo mv lla /usr/local/bin/lla

Linux releases include GNU binaries for amd64, arm64, and i686. Static musl binaries are available as lla-linux-amd64-musl and lla-linux-arm64-musl; the install script selects them on musl systems. Static musl builds support core listing, formatting, search, archives, themes, configuration, and upgrades, but not dynamically loaded plugins. The 32-bit x86 .apk is a GNU-based legacy package.

NetBSD releases include lla-netbsd-amd64, which the install script selects on NetBSD amd64. It is built natively with the default feature set: native dynamic plugins are enabled, but the embedded WASM runtime is omitted because Wasmtime does not support NetBSD. Official prebuilt plugin archives are not currently published for NetBSD; native plugins can still be built and installed locally.

Windows releases include lla-windows-amd64.exe and lla-windows-arm64.exe, built natively with wasm-plugins. Matching plugins-windows-amd64.zip and plugins-windows-arm64.zip archives contain native DLLs and WASM components. Windows reports file size and timestamps normally, synthesizes Unix-style permission columns from file type and the read-only attribute, and returns null or - for Unix-only ownership, inode, hard-link, xattr, security-context, and mount metadata. Supported systems are Windows 10 or Windows Server 2016 and newer on AMD64 or ARM64; 32-bit x86 is rejected by the installer.

Creating symlinks may require Windows Developer Mode or an elevated terminal. Existing directory and file symlinks can still be listed normally when the current account can access them.

Initialize lla

Run the guided setup after installation:

lla init

The wizard configures appearance, the default view, permission formatting, listing and sorting defaults, dotfile and .gitignore behavior, long-view columns, plugin directories and enablement, and recursion safety limits.

To write the built-in defaults without prompts, or inspect the active config:

lla init --default
lla config

The configuration file is stored at ~/.config/lla/config.toml. See Configuration for profiles, themes, shortcuts, and the supported settings.

Upgrade

lla upgrade
lla upgrade --version v0.5.1
lla upgrade --path /usr/local/bin/lla

lla upgrade uses the official installation logic to detect the platform, verify SHA256SUMS, and atomically replace the executable. It targets the currently running executable unless --path is provided. NetBSD amd64 upgrades select the lla-netbsd-amd64 release asset. Windows upgrades select the matching .exe asset and use a Windows-safe self-replacement path.

Next steps