Skip to content

installation.md

Latest commit

 

History

History
72 lines (53 loc) · 2.33 KB

installation.md

File metadata and controls

72 lines (53 loc) · 2.33 KB
Raw

Installing Libra

Script installer

The recommended macOS/Linux installation is:

curl -fsSL https://download.libra.tools/install.sh | sh

The installer places libra in $LIBRA_HOME/bin (~/.libra/bin by default), writes shell environment files, and creates the optional relative symlink:

~/.libra/bin/lba -> libra

Both names execute the same binary. The relative target remains valid when the whole Libra home directory is moved.

Alias safety and idempotency

  • A fresh install creates lba by default.
  • Re-running the installer for the already-installed version repairs a missing alias without downloading or replacing libra.
  • A valid lba -> libra or lba -> $LIBRA_INSTALL_DIR/libra symlink is accepted and refreshed to the relative form.
  • A regular file, directory, or symlink to another target named lba is user-owned and is never overwritten. The installer prints a warning and continues.
  • If the platform or filesystem cannot create symlinks, installing libra still succeeds. Use the full libra command after the warning.

The installer does not create a copy, hard link, shell function, or alias in a profile. lba is only the optional filesystem symlink beside libra.

Opting out

Use the flag for one invocation:

curl -fsSL https://download.libra.tools/install.sh | sh -s -- --no-alias

Or set the environment variable for automated installations:

curl -fsSL https://download.libra.tools/install.sh | LIBRA_NO_ALIAS=1 sh

The opt-out does not remove an existing alias; it only prevents the current installer run from creating or refreshing one. Remove a known Libra-owned symlink explicitly if desired:

test "$(readlink "$HOME/.libra/bin/lba" 2>/dev/null)" = libra &&
    rm "$HOME/.libra/bin/lba"

Related options

Option / variable Effect
-v, --version <VERSION> Install a specific release
-d, --dir <PATH> Override the binary directory
LIBRA_INSTALL_DIR Environment equivalent for the binary directory
--no-modify-path Write env files but do not edit shell rc files
--no-alias Do not create or refresh lba for this run
LIBRA_NO_ALIAS=1 Environment opt-out for lba

Run sh install.sh --help from a checkout for the complete option and environment-variable list.