---
title: "Updating"
description: "Keep Nexus OS up to date to get the latest features and bug fixes. The force flag overwrites the existing installation. Download the latest binary from the Releases page and replace the existing binary. When updating, Ne"
resource: https://www.aiagents.nexus/docs/manual/installation/updating
generated: { by: "process:nexus-agent-assets", at: 2026-09-07T09:13:03Z }
status: stable
---

# Updating Nexus OS

Keep Nexus OS up to date to get the latest features and bug fixes.

## Update via Cargo (Recommended)

```bash
cargo install --git https://github.com/leonidas-esquire/nexus-os.git --force
```

The `--force` flag overwrites the existing installation.

## Update via Binary Download

Download the latest binary from the [Releases](https://github.com/leonidas-esquire/nexus-os/releases) page and replace the existing binary.

## Update from Source

```bash
cd nexus-os
git pull origin main
cargo build --release
sudo cp target/release/naos /usr/local/bin/
```

## Check Current Version

```bash
naos --version
```

## Database Migrations

When updating, Nexus OS automatically migrates your SQLite database:

```bash
naos status
# ✓ Database migrated from v3 to v5
# Project: my-project
# ...
```

Migrations are non-destructive — your data is preserved.

## Rollback

If you need to go back to a previous version:

```bash
# If installed via cargo
cargo install --git https://github.com/leonidas-esquire/nexus-os.git --tag v0.1.0

# If installed from source
git checkout v0.1.0
cargo build --release
```

> **Note**: Downgrading may not undo database migrations. Back up your `data/` directory before downgrading.