Nomad
Nomad 2.0.x release notes
Nomad version support
Beginning in April 2026, HashiCorp's self-managed products adopt new version, release, and support models. Nomad continues to target Spring and Fall feature releases, with monthly updates as needed. These changes align with IBM's enterprise software lifecycle to ensure consistent support across IBM's software portfolio.
| Version | Base Support End | Extended Support End | Ongoing Extended Support End |
|---|---|---|---|
| 1.8.x.(LTS) | April 30, 2026 | April 30, 2026 | April 30, 2026 |
| 1.10.x (LTS) | April 30, 2027 | April 30, 2027 | April 30, 2027 |
| 1.11.x | October 31, 2026 | October 31, 2026 | October 31, 2026 |
| 2.0.x | April 30, 2028 | April 30, 2029 | April 30, 2032 |
Note that Extended Support and Ongoing Extended Support are optional, paid support packages available to Enterprise customers.
Beginning with the 2.0.0 release, HashiCorp Nomad's existing semantic versioning format (X.Y.Z) moves to IBM's Version-Modification-Fix (V.M.F) model. This mapping helps make lifecycle timing clear and consistent across products.
- April ("V" milestone): Starts a new support lifecycle for the version.
- October ("M" milestone): Adds new features but does not start a new support lifecycle.
- Monthly ("F" fixes): Patch release.
Refer to the following for additional details:
- IBM HashiCorp Self-Managed Product Support Lifecycle Addendum
- Changes to HashiCorp Self-Managed Enterprise Product Release Cadence and Support
- HashiCorp Long-Term Support (LTS) releases for products released prior to March 2025. Nomad v1.10.x is the last LTS release.
- IBM Software Support Lifecycle Policies
2.0.0 release highlights
Release Date: 21 April 2026
Command to migrate Raft log store to Write-Ahead Log (WAL) backend
The nomad operator raft migrate-backend command migrates the Raft log store
from the BoltDB backend to the Write-Ahead Log (WAL) backend. Compared to
BoltDB, the WAL backend provides better performance characteristics for
write-heavy workloads. However, once migrated to WAL, reverting back to BoltDB
requires restoring from a snapshot taken before the migration.
We added the following:
nomad operator raft migrate-backendcommand reference- Raft log store details to the
/v1/agent/selfAPI endpoint response raft_logstoreparameter to server configuration- WAL backend metrics to the Raft log store metrics
We deprecated the server configuration's raft_boltdb
parameter.
License and configuration changes to enable use of IBM Passport Advantage Online (PAO) Enterprise
Enterprise
We extended Nomad's existing licensing and reporting functionality to support parsing and reporting with the IBM PAO license.
In Nomad 2.0, we changed the licensing log and error output. This may impact scripted upgrades if your script relies on error output text.
| Type | Old Output | New Output |
|---|---|---|
| Error | "invalid license config: %w" | "invalid license data: %w" |
| Error | "error initializing licensing validator: %w" | (removed — function deleted) |
| Error | "failed to initialize nomad license: %w" | "failed to set nomad license: %w" |
| Error | (none — error was returned bare) | "failed to set nomad license: %w" |
| Error | "error validating license: %w" | (removed) |
| Log (Error) | "failed to persist license" | (removed) |
| Error | "failed to retrieve license: %w" | (removed) |
| Error | "failed to convert license: %w" | (removed) |
| Log (Error) | "license expired, please update license" (fromErrorCh) | "license is inactive, please update license" (from ErrorCh) |
| Log (Error) | (none) | "license expired, please update license" (now from WarningCh) |
| Log (Warn) | "license expiring" withtime.Until(warnLicense.ExpirationTime).Truncate(time.Second) | "license expiring" with status.TimeToExpire.String() (now from StatusCh) |
| Error | "could not create reporting bundle: no snapshots" | "no snapshots" |
Changelog
Review improvements, security fixes, and breaking changes in the changelog.