---
title: "eliza update"
description: "Check for and install updates, or switch release channels."
---

# `eliza update`

Checks for updates and optionally installs them. Supports three release channels: `stable`, `beta`, and `nightly`.

## Options

| Flag | Description |
|------|-------------|
| `-c, --channel <channel>` | Switch release channel before checking (stable, beta, nightly) |
| `--check` | Check for updates without installing |
| `--force` | Force update check (bypass interval cache) |

## Subcommands

### `eliza update status`

Show the current installed version, release channel, install method, and available versions across all channels.

```bash
eliza update status
```

### `eliza update channel [channel]`

View the current release channel, or switch to a different one. Without an argument, displays all available channels and the active one.

```bash
eliza update channel
eliza update channel beta
eliza update channel stable
```

## Examples

```bash
# Check and install updates on the current channel
eliza update

# Check only, don't install
eliza update --check

# Switch to beta and update
eliza update --channel beta

# Force a fresh check (bypass cache)
eliza update --force
```

## Update channels

Configure which release channel to follow in `~/.eliza/eliza.json`:

```json5
{
  update: {
    channel: "stable",          // "stable" | "beta" | "nightly"
    checkOnStart: true,         // check for updates when eliza starts
    checkIntervalSeconds: 14400, // 4 hours between checks
  },
}
```

## Desktop app

The desktop app checks for updates automatically on launch. Updates are downloaded in the background and applied on next restart.

## Related

- [Self-updates](/self-updates) — Update mechanism details
- [Build and release](/build-and-release) — Release process documentation