# Network-wide Software Upgrades

## Context

Updates to the ledger code running on cheqd mainnet/testnet is voted in via governance proposals on-chain for "breaking" software changes.

We use [semantic versioning](https://semver.org/) to define our software release versions. The latest software version running on chain is in the **v2.x.x** family. Any new release versions that bump only the minor/fix version digits (the second and the third part of release version numbers) is intended to be **compatible** within the family and **does not require** an on-chain upgrade proposal to be made.

## Creating a new software upgrade proposal

Network-wide software upgrades are typically initiated by the core development team behind the cheqd project. The process followed for the network upgrade is defined in our [guide on creating a Software Upgrade proposal](/node/validator-guides/upgrades/propose-software-upgrade.md) via network governance.

Additionally, these software upgrades are discussed off-chain on [our discussion forum](https://commonwealth.im/cheqd/discussions) and on [our Discord server](http://cheqd.link/discord-github).

## Upgrade Process

You can find more details on the actual upgrade process under in our [Upgrade Process Guide](/node/validator-guides/upgrades/upgrade-process.md)

## Previous software upgrade guides

[This section](/node/validator-guides/upgrades/upgrade-guides.md) lists **previous** software upgrade proposals and specific instructions on how to execute them.

* [v0.6.0 Upgrade Guide](/node/validator-guides/upgrades/upgrade-guides/v0.6-upgrade.md)
* [v2.x Upgrade Guide](/node/validator-guides/upgrades/upgrade-guides/v2.x-upgrade.md)
* [v3.x Upgrade Guide](/node/validator-guides/upgrades/upgrade-guides/v3.x-upgrade.md)
* [v3.1.x Upgrade Guide](/node/validator-guides/upgrades/upgrade-guides/v3.1.x-upgrade.md)
* [v4.x Upgrade Guide](/node/validator-guides/upgrades/upgrade-guides/v4.x-upgrade.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cheqd.io/node/validator-guides/upgrades.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.