Installing the Hazelcast CLC

The Hazelcast Command-Line Client (CLC) is available to install in macOS, Linux, and Windows environments. You can install the Hazelcast CLC, using one of the following:

Downloading a pre-built binary
Windows installer
Building from source

Installing on macOS

The Hazelcast CLC is supported on macOS 13 or newer versions.

ZIP (Intel)
ZIP (Apple Silicon)
Build from Source

Go to the latest release page, and locate the AMD compressed file (hazelcast-clc_v5.2.1_darwin_amd64.zip).
Download and unzip the file.
Optionally make clc available without using its full path. You can do that by moving clc to one of the directories in the $PATH environment variable. /usr/local/bin is a safe choice.
```
sudo mv hazelcast-clc_v5.2.1_darwin_amd64/clc /usr/local/bin
```

Go to the latest release page, and locate the ARM compressed file (hazelcast-clc_v5.2.1_darwin_arm64.zip).
Download and unzip the file.
Optionally make clc available without using its full path. You can do that by moving clc to one of the directories in the $PATH environment variable. /usr/local/bin is a safe choice.
```
sudo mv hazelcast-clc_v5.2.1_darwin_arm64/clc /usr/local/bin
```

Make sure the following are installed:
- GNU Make (check with the make --version command). If it is not already installed, you can install Xcode Command Line Tools Package.
  xcode-select --install
- Go 1.19 or newer (check with the go version command)
Go to the latest release page, and locate the compressed source file (v5.2.1.zip).
Download and unzip the file.
Change into the hazelcast-commandline-client-5.2.1 directory.
```
cd hazelcast-commandline-client-5.2.1
```
Run the following command to build the Hazelcast CLC.
```
CLC_VERSION=v5.2.1 make
```
The clc binary is created in the build directory.
Run the following command to start the Hazelcast CLC.
```
./build/clc
```
Optionally make clc available without using its full path. You can do that by moving clc to one of the directories in the $PATH environment variable. /usr/local/bin is a safe choice.
```
sudo mv ./build/clc /usr/local/bin
```

Installing on Linux

The Hazelcast CLC runs on any recent Linux distribution. We test it on Ubuntu 22.04.

Tarball (AMD64)
Build from Source

Go to the latest release page, and locate the tarball for Linux (hazelcast-clc_v5.2.1_linux_amd64.tar.gz).
Download and unzip the file.
Optionally make clc available without using its full path. You can do that by moving clc to one of the directories in the $PATH environment variable. /usr/local/bin is a safe choice.
```
sudo mv hazelcast-clc_v5.2.1_linux_amd64/clc /usr/local/bin
```

Make sure the following are installed:
- GNU Make (check with the make --version command). It is installed by default on most Linux distributions.
- Go 1.19 or newer (check with the go version command)
Go to the latest release page, and locate the source tarball (v5.2.1.tar.gz).
Download and uncompress the file.
```
tar xf v5.2.1.tar.gz
```
Change into the hazelcast-commandline-client-5.2.1 directory.
```
cd hazelcast-commandline-client-5.2.1
```
Run the following command to build the Hazelcast CLC.
```
CLC_VERSION=v5.2.1 make
```
The clc binary is created in the build directory.
Run the following command to start the Hazelcast CLC.
```
./build/clc
```
Optionally make clc available without using its full path. You can do that by moving clc to one of the directories in the $PATH environment variable. /usr/local/bin is a safe choice.
```
sudo mv ./build/clc /usr/local/bin
```

Installing on Windows

The Hazelcast CLC is supported on Windows 10 or newer versions. We provide pre-built binaries only for 64bit Intel/AMD architecture.

Installer
ZIP

Go to the latest release page, and locate the Windows installer file (hazelcast-clc-setup-v5.2.1.exe).
Download and the run the installer on your system to start the installation wizard.
Follow the steps on the wizard; when you see the "Completing the Hazelcast CLC Setup Wizard" dialog, press Finish to complete the installation.
clc.exe is automatically added to the PATH environment variable, so it can be started in the terminal without its full path.
Start the Hazelcast CLC from the start menu or by running the following command.
```
clc.exe
```

Go to the latest release page, and locate the Windows ZIP file (hazelcast-clc_v5.2.1_windows_amd64.zip).
Download and unzip the file.
Optionally make clc.exe available without using its full path. You can do that by adding the full path of the extracted directory to the PATH environment variable.

Verifying the Hazelcast CLC Installation

To check whether the Hazelcast CLC is installed properly, run the following command on a terminal.

clc version

You should see the Hazelcast CLC version information.

Uninstalling the Hazelcast CLC

Choose the option that corresponds to your installation method.

Windows
Release Package

Go to Apps & Features setting (Start menu → Windows Settings → Apps).
Locate Hazelcast CLC version 5.2.1 under Apps & Features list.
Right-click on it and select Uninstall.
Press Yes on the uninstallation dialog.

Delete the hazelcast-commandline-client directory.

Next Steps

In this section you’ve learnt how to install the Hazelcast CLC on the supported operating systems. To start using the Hazelcast CLC, check the following resources:

See Configuration to configure the details of the connection between the Hazelcast CLC and a Hazelcast Platform cluster.
See Command Reference for a complete list and descriptions of commands you can use with the Hazelcast CLC.