> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/zenlayer-cli/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/zenlayer-cli/install.md).

# Install the CLI

This guide will help you install Zenlayer Cloud CLI (`zeno`) on different platforms.

## System Requirements

* **Linux**: Supports major Linux distributions
* **macOS**: Supports macOS 10.15 and above
* **Windows**: Supports Windows 10 and above

## Installation Methods

### Method 1: Quick Install (Linux / macOS) (Recommended)

```bash
curl -fsSL https://raw.githubusercontent.com/zenlayer/zenlayercloud-cli/main/install.sh | bash
```

### Method 2: Pre-built Binaries

Download pre-built binaries for your platform from the [GitHub Releases](https://github.com/zenlayer/zenlayercloud-cli/releases) page:

| Platform | Architecture | Binary                   |
| -------- | ------------ | ------------------------ |
| Linux    | amd64        | `zeno_linux_amd64`       |
| Linux    | arm64        | `zeno_linux_arm64`       |
| macOS    | Universal    | `zeno_darwin_all`        |
| Windows  | amd64        | `zeno_windows_amd64.exe` |

After downloading:

* **Linux/macOS**:

  ```bash
  # Move the binary to a directory in your system PATH
  chmod +x zeno_*_*
  sudo mv zeno_*_* /usr/local/bin/zeno
  ```
* **Windows**:
  * Rename the downloaded `zeno_windows_amd64.exe` file to `zeno.exe`
  * Move it to a directory included in your system PATH environment variable, such as `C:\Windows\System32`

### Method 3: Build from Source

Requires Go 1.21 or later.

```bash
git clone https://github.com/zenlayer/zenlayercloud-cli.git
cd zenlayercloud-cli
make build
```

The compiled binary is located at `bin/zeno`.

## Verify Installation

After installation, run the following command to verify that Zenlayer Cloud CLI is installed successfully:

```bash
zeno version
```

If the installation is successful, you will see the corresponding version number output:

```
1.0.0
```

## Upgrade the CLI

To upgrade Zenlayer Cloud CLI, simply re-run the quick install command:

```bash
curl -fsSL https://raw.githubusercontent.com/zenlayer/zenlayercloud-cli/main/install.sh | bash
```

Or reinstall the latest version using any of the other installation methods described above.

## Uninstall the CLI

To uninstall Zenlayer Cloud CLI, simply delete the corresponding binary:

* **Linux/macOS**:

  ```bash
  sudo rm /usr/local/bin/zeno
  ```
* **Windows**:
  * Delete the `zeno.exe` file that was previously moved to a system PATH directory

## FAQ

### Permission Errors

If you encounter permission errors during installation, make sure you have sufficient permissions to move files to system directories. On Linux/macOS, you can use the `sudo` command to gain administrator privileges.

### Command Not Found

If you get a "command not found" error when running the `zeno` command, make sure the binary has been correctly installed to a directory in your system PATH, or you can use the absolute path to run the binary.

## Next Steps

After installation, you can continue reading the [Configuration Guide](/zenlayer-cli/configure.md) to configure access credentials for Zenlayer Cloud CLI.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.console.zenlayer.com/zenlayer-cli/install.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.