> 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/usage/upgrade.md).

# Upgrading zeno

The `zeno upgrade` command checks GitHub Releases for a newer version of zeno and installs it in place.

## Synopsis

```
zeno upgrade [flags]
```

## Flags

| Flag              | Short | Description                                |
| ----------------- | ----- | ------------------------------------------ |
| `--check`         |       | Check for updates without installing       |
| `--list`          |       | List all available versions                |
| `--version <tag>` |       | Install a specific version (e.g. `v1.0.1`) |
| `--yes`           | `-y`  | Skip confirmation prompt                   |
| `--rollback`      |       | Roll back to the previous backup version   |

## Examples

**Upgrade to the latest version:**

```bash
zeno upgrade
```

```
Current version: v1.0.2
Target version:  v1.0.3
Proceed with upgrade? [y/N]: y
Downloading zeno_1.0.3_darwin_all.tar.gz...
Verifying checksum...
Extracting...
Installing...
Successfully upgraded zeno to v1.0.3
```

**Check whether a newer version is available (no install):**

```bash
zeno upgrade --check
```

```
Update available: v1.0.2 → v1.0.3
```

**List all available versions:**

```bash
zeno upgrade --list
```

```
  v1.0.3
  v1.0.2  *
  v1.0.1
  v1.0.0
```

The `*` marks the currently installed version.

**Install a specific version:**

```bash
zeno upgrade --version v1.0.1
```

**Skip confirmation prompt:**

```bash
zeno upgrade --yes
```

**Roll back to the previous version:**

```bash
zeno upgrade --rollback
```

```
Rolling back to previous version...
Rollback successful.
```

> Note: rollback requires a backup file (`.bak`) left by a previous upgrade. If no backup exists, an error is returned.

## Notes

* Supported platforms: Linux (amd64/arm64) and macOS (universal binary).
* If zeno is installed in a system directory (e.g. `/usr/local/bin`), you may need to run the command with elevated privileges:

  ```bash
  sudo zeno upgrade
  ```


---

# 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/usage/upgrade.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.