---
title: "Migration Guide"
description: "How to upgrade between Nexus OS versions. v0.1.0 is the first public release. If you were using a pre release version: The database schema changed significantly. Export and reimport: Old Command New Command naos agent li"
resource: https://www.aiagents.nexus/docs/manual/appendix/migration-guide
generated: { by: "process:nexus-agent-assets", at: 2026-09-07T09:13:03Z }
status: stable
---

# Migration Guide

How to upgrade between Nexus OS versions.

## v0.0.x to v0.1.0

v0.1.0 is the first public release. If you were using a pre-release version:

### Config Changes

```yaml
# OLD (v0.0.x)
agents:
  - name: planner
    type: llm

# NEW (v0.1.0)
agents:
  planner:
    template: llm
    source: agents/planner.wasm
```

### Database Migration

The database schema changed significantly. Export and reimport:

```bash
# Export old data
naos export --format json --output backup.json

# Reinitialize
rm -rf data/
naos init

# Import data
naos import backup.json
```

### CLI Changes

| Old Command | New Command |
|-------------|-------------|
| `naos agent list` | `naos list` |
| `naos agent create` | `naos create` |
| `naos agent run` | `naos run` |
| `naos agent stop` | `naos stop` |

## Future Migrations

Starting with v0.1.0, Nexus OS includes automatic database migrations. When you upgrade, the database schema is updated automatically on first run.

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

# Run any command — migrations happen automatically
naos list
# [info] Migrated database from v3 to v5
```