> For the complete documentation index, see [llms.txt](https://docs.cloudeka.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudeka.ai/guidance-for-enterprise/cloudeka-api-list/how-to-install-cldkctl/install-for-mac-os.md).

# Install for Mac OS

{% hint style="danger" %}
If the cldkctl binary is downloaded manually and executed from the current directory, prefix the command with ./, for example ./cldkctl --version. This ensures that the system executes the local binary, as macOS does not include the current directory (./) in the system PATH by default.
{% endhint %}

The cldkctl tool for macOS can be installed using either the Homebrew package manager or the Manual Binary Installation method. Choose one of the methods below based on the preferred installation approach.

Install via Homebrew

1. Open the Terminal application.
2. Run the following command to add the repository and install cldkctl:

```
brew tap Lintasarta/cldkctl https://github.com/Lintasarta/cldkctl.git
brew install cldkctl
```

3. After the installation is complete, verify it by typing:

```
cldkctl --version
```

4. If the version number appears, the installation was successful.

**Manual Binary Installation**

1. Open the Manual Binary Installation section on the Service Portal AI.
2. Download the latest cldkctl binary from the GitHub Releases page.
3. Extract the downloaded file.
4. Move the extracted cldkctl binary to `/usr/local/bin/.`
5. Assign execution permission to the binary by running:

```
chmod +x /usr/local/bin/cldkctl
```

6. Verify the installation by running:

```
cldkctl --version
```

7. Once the version number appears, the installation is complete.
