---
title: "Release Process"
description: "How Nexus OS releases are managed. Nexus OS follows Semantic Versioning (SemVer): MAJOR — Breaking changes to CLI or config format MINOR — New features, backward compatible PATCH — Bug fixes only 1. Update version in Car"
resource: https://www.aiagents.nexus/docs/manual/contributing/release-process
generated: { by: "process:nexus-agent-assets", at: 2026-09-07T09:13:03Z }
status: stable
---

# Release Process

How Nexus OS releases are managed.

## Versioning

Nexus OS follows Semantic Versioning (SemVer):

- **MAJOR** — Breaking changes to CLI or config format
- **MINOR** — New features, backward compatible
- **PATCH** — Bug fixes only

## Release Checklist

1. Update version in `Cargo.toml`
2. Update CHANGELOG.md
3. Run full test suite
4. Build release binaries for all platforms
5. Create GitHub release with binaries
6. Update Homebrew formula
7. Update documentation site

## Building Release Binaries

```bash
# Linux (x86_64)
cargo build --release --target x86_64-unknown-linux-musl

# macOS (Apple Silicon)
cargo build --release --target aarch64-apple-darwin

# macOS (Intel)
cargo build --release --target x86_64-apple-darwin

# Windows
cargo build --release --target x86_64-pc-windows-msvc
```

## Platform Support

| Platform | Architecture | Status |
|----------|-------------|--------|
| Linux | x86_64 | Tier 1 |
| Linux | aarch64 | Tier 1 |
| macOS | Apple Silicon | Tier 1 |
| macOS | Intel | Tier 1 |
| Windows | x86_64 | Tier 2 |
| FreeBSD | x86_64 | Tier 3 |