Localazy CLI is available as a native app for all major platforms (Windows, Linux and macOS), Java’s JAR, npm package and Docker image.

For more information about using Localazy CLI please refer to basics and command-line options.

Java/JVM #️⃣

For using the Java version of Localazy CLI, you need JRE/JDK 8 and above available on your machine.

Download:

Run CLI:

java -jar localazy.jar [command] [options] [groups]

Linux #️⃣

Localazy CLI for Linux is a native app, and it only has single dependency on libcurl (for HTTPS communication).

Debian/Ubuntu #️⃣

Add repository and install:

Recommended way after apt-key gets deprecated:

curl -sS https://dist.localazy.com/debian/pubkey.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/localazy.gpg
echo "deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/localazy.gpg] https://maven.localazy.com/repository/apt/ stable main" | sudo tee /etc/apt/sources.list.d/localazy.list

sudo apt-get update && sudo apt-get install localazy

Old way with apt-key:

curl -sS https://dist.localazy.com/debian/pubkey.gpg | sudo apt-key add - 
echo "deb [arch=amd64] https://maven.localazy.com/repository/apt/ stable main" | sudo tee /etc/apt/sources.list.d/localazy.list

sudo apt-get update && sudo apt-get install localazy

Run CLI:

localazy [command] [options] [groups]

RHEL/CentOS #️⃣

Download and install:

curl -sS https://dist.localazy.com/rhel/localazy.repo | tee /etc/yum.repos.d/localazy.repo

yum install localazy

Run CLI:

localazy [command] [options] [groups]

Manual installation #️⃣

If the libcurl is not installed on your system, install it:

  • Debian/Ubuntu: apt install libcurl4
  • or use the standard package manager for your distribution

Download DEB:

Download RPM:

Download binary:

Run CLI:

localazy [command] [options] [groups]

Autocomplete for bash / zsh #️⃣

You can generate and install the autocomplete script for your shell by invoking command:

# for bash
sudo mkdir -p /usr/share/bash-completion/completions && sudo bash -c '_LOCALAZY_COMPLETE=bash localazy > /usr/share/bash-completion/completions/localazy'

# for zsh
_LOCALAZY_COMPLETE=zsh localazy > ~/.localazy-autocomplete.sh && echo source ~/.localazy-autocomplete.sh >> ~/.zshrc

The bash autocomplete script is installed automatically when installed from repository, DEB or RPM.

macOS #️⃣

For ARM-based macOS, if you encounter any issue running our CLI, you can use a JVM-based Docker container.

Localazy CLI is available through brew; just use the command-line to install it:

> brew tap localazy/tools
> brew install localazy

In the future, you can update to the latest version of Localazy CLI with:

> brew upgrade localazy

Run CLI:

localazy [command] [options] [groups]

You can also download the binary directly. However, it depends on libcurl (can be installed with brew install curl).

Download direct binary:

Windows #️⃣

Localazy CLI for Windows is a native app and has no dependencies.

Download:

Run CLI:

.\localazy.exe [command] [options] [groups]

Note: Whenever working with file paths in the Localazy configuration file, we strongly advise you to use POSIX / path separator instead of the backslash. It simplifies parsing and writing transformation rules.

NPM #️⃣

The Localazy CLI is available on NPM repository as @localazy/cli.

Install:

npm install -g @localazy/cli

Run CLI:

localazy [command] [options] [groups]

Note: Node.js v11+ and NPM v6+ are required to run Localazy CLI.

Docker #️⃣

Docker is currently not supported on ARM-based Macs. Please use NPM or JVM version to build your own image.

The Localazy CLI is available on Docker repository as localazy/cli. It has no entrypoint and no cmd and the localazy command is supposed to be run manually as per your needs.

The container is based on ubuntu:18.04 so you can easily reuse it for more purposes.

The workdir inside the container is /localazy and you should mount your working directory to it using -v parameter.

Typical usage

docker run --rm -v $(pwd):/localazy localazy/cli:latest localazy [command] [options] [groups]

Details:

  • --rm - the container is removed automatically when the operation finishes
  • -v $(pwd):/localazy - mount the current directory as working directory
  • localazy/cli:latest - use the latest available Localazy CLI version
  • localazy [command] [options] [groups] - the actual invocation of Localazy CLI

Notes #️⃣

The native version of Localazy CLI available for Windows, Linux and macOS requires 64-bit system.

If you are still running 32-bit system, please use Java version with appropriate 32-bit JRE/JDK.