RackPeek/Shared.Rcl/wwwroot/raw_docs/versioning.md

Versioning

RackPeek follows Semantic Versioning (SemVer) for both the CLI and Docker images:

MAJOR.MINOR.PATCH
Example: 1.2.3

MAJOR (X.0.0)

• Sweeping changes to the CLI / WebUi
• Large schema changes
• Breaking Changes

MINOR (1.X.0)

Backward-compatible features:

• New CLI commands or flags
• New WebUI features
• New config options
• Performance improvements

PATCH (1.0.X)

Backward-compatible fixes:

• Bug fixes
• Security patches
• Docs or minor UX improvements

CLI & Docker

The CLI and Docker image share the same version number.

Docker tags:

• latest → newest stable
• v1.2.3 → Major Minor Patch

For production, pin to a specific version instead of latest.

Versioning

RackPeek follows Semantic Versioning (SemVer) for both the CLI and Docker images:

MAJOR.MINOR.PATCH
Example: 1.2.3

MAJOR (X.0.0)

Breaking changes:

• CLI command/flag changes
• config.yaml structure changes
• Removed/renamed fields
• Behavior requiring migration

MINOR (1.X.0)

Backward-compatible features:

• New CLI commands or flags
• New WebUI features
• New non-breaking config options
• Performance improvements

PATCH (1.0.X)

Backward-compatible fixes:

• Bug fixes
• Security patches
• Docs / minor UX improvements

CLI & Docker

The CLI binary and Docker image share the same version number.

Docker tags:

• latest → newest stable release
• 1 → latest major
• 1.2 → latest patch in that minor line
• 1.2.3 → exact immutable version (recommended for production)

Nightly Docker Builds

In addition to stable releases, RackPeek publishes a nightly Docker image from the main branch.

• Triggered on every push to main
• Built for linux/amd64

• Tagged as:

  • aptacode/rackpeek:nightly
  • aptacode/rackpeek:nightly-<short-sha>

Nightly images provide early access to upcoming changes and are intended for testing and development (not production use).