Updating Nexus OS

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

Update via Cargo (Recommended)

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 page and replace the existing binary.

Update from Source

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

Check Current Version

naos --version

Database Migrations

When updating, Nexus OS automatically migrates your SQLite database:

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:

# 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.