Skip to main content
🛠 This page is for engineering teams self-hosting their own Lightdash instance. If you’re on Lightdash Cloud, upgrades are handled for you automatically.
Lightdash uses semantic versioning in the form major.minor.patch. Each segment signals how significant the changes are and what level of care you should take when upgrading.

​
How Lightdash versioning works

  • Patch versions (x.x.PATCH) are small fixes. These are safe to pick up as part of routine upgrades.
  • Minor versions (x.MINOR.x) introduce new features or bigger changes that are backwards incompatible. Review the release notes before upgrading.
  • Major versions (MAJOR.x.x) introduce breaking changes. You must read the upgrade guides below before upgrading.
Major version bumps can happen because the API or the self-hosted architecture has changed substantially. Expect to make configuration, infrastructure, or integration changes when moving between major versions.

​
Upgrade guides

​
Upgrading from Version 0 to Version 1

Coming soon.