> 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](https://docs.console.zenlayer.com/zenlayer-cli/configure.md) to configure access credentials for Zenlayer Cloud CLI.
