diff --git a/src/content/docs/aws/capabilities/config/docker-images.md b/src/content/docs/aws/capabilities/config/docker-images.md index b91e6660..ec65a52d 100644 --- a/src/content/docs/aws/capabilities/config/docker-images.md +++ b/src/content/docs/aws/capabilities/config/docker-images.md @@ -54,7 +54,10 @@ The [BigData image](https://hub.docker.com/r/localstack/bigdata/tags), which sta ## Image tags -We use tags for versions with significant features, enhancements, or bug fixes - following [semantic versioning](https://semver.org). +Starting with the end-of-March 2026 release, LocalStack version tags follow +[calendar versioning](https://calver.org/) in the `YYYY.MM.patch` format (for example, `2026.03.0`). + +Releases up to and including `v4.14.0` use [semantic versioning](https://semver.org). To ensure that we move quickly and steadily, we run nightly builds, where all our updates are available on the `latest` tag of LocalStack's Docker image. We intend to announce more significant features and enhancements during major & minor releases. We occasionally create patch releases for minor bug fixes and enhancements, to ensure that we can deliver changes quickly while not breaking your existing workflows (in case you prefer not to use `latest`). diff --git a/src/content/docs/aws/changelog.md b/src/content/docs/aws/changelog.md index c493434e..35e17bc9 100644 --- a/src/content/docs/aws/changelog.md +++ b/src/content/docs/aws/changelog.md @@ -9,7 +9,7 @@ pagefind: false Browse release notes for official LocalStack major and minor releases since LocalStack v1.0.0. If you are looking for information about nightly releases, preview features, or experimental features, pull the [latest Docker image](https://hub.docker.com/r/localstack/localstack). -Our changelog is updated with every release. +Our changelog is updated with every release. Updates that affect only LocalStack Web Application or features in preview or limited release may not be reflected. @@ -26,8 +26,12 @@ Disclaimer: Features under development (i.e., labelled as preview/beta, experime ## Official Releases -LocalStack follows [Semantic Versioning](https://semver.org/) except for [AWS parity](https://localstack.cloud/blog/2022-08-04-parity-explained) fixes, -which can be released as patch version because we are committed to make LocalStack behave the same way AWS does. +Starting with the end-of-March 2026 release, LocalStack for AWS follows +[calendar versioning](https://calver.org/) using the `YYYY.MM.patch` format. +For example, `2026.03.0` is the initial March 2026 release and patch releases in the same month increment +the last segment (`2026.03.1`, `2026.03.2`, and so on). + +Releases up to and including `v4.14.0` continue to use [Semantic Versioning](https://semver.org/). | Version | Release Date | Release Notes | |-----------|--------------------|----------------------------------------------------------------------------------------------------| diff --git a/src/content/docs/aws/getting-started/faq.mdx b/src/content/docs/aws/getting-started/faq.mdx index 0a511f77..6dbd8f35 100644 --- a/src/content/docs/aws/getting-started/faq.mdx +++ b/src/content/docs/aws/getting-started/faq.mdx @@ -82,19 +82,15 @@ These tags have different semantics and will be updated on different occasions: It will be updated with every release of LocalStack. - This also entails major releases, which means that this tag can contain breaking changes. - This tag should be used if you want to stay up-to-date with releases, but don't necessarily need the latest and greatest changes right away. -- `` (e.g. `3`) - - These tags can be used to refer to the latest release of a specific major release. - It will be updated with every minor and patch release within this major release. - - This tag should be used if you want to avoid any potential breaking changes. -- `.` (e.g. `3.0`) - - These tags can be used to refer to the latest release of a specific minor release. - It will be updated with every patch release within this minor release. - - This tag can be used if you want to avoid any bigger changes, like new features, but still want to update to the latest bugfix release. -- `..` (e.g. `3.0.2`) +- `` (e.g. `2026.03.0`) - These tags can be used if you want to use a very specific release. It will not be updated. - This tag can be used if you really want to avoid any changes to the image (not even minimal bug fixes). +Starting with the end-of-March 2026 release, LocalStack follows [calendar versioning](https://calver.org/) for official releases. + +For releases up to and including `v4.14.0`, tags follow Semantic Versioning. + ### How can I access LocalStack from an alternative computer? You can access LocalStack from an alternative computer, by exposing port `4566` to the public network interface (`0.0.0.0` instead of `127.0.0.1`) in your `docker-compose.yml` configuration. diff --git a/src/content/docs/azure/changelog.mdx b/src/content/docs/azure/changelog.mdx index ad11745a..d1120ae6 100644 --- a/src/content/docs/azure/changelog.mdx +++ b/src/content/docs/azure/changelog.mdx @@ -6,6 +6,10 @@ template: doc This changelog tracks updates to LocalStack for Azure support, including new services, enhancements, and compatibility fixes. +Starting with the end-of-March 2026 release, LocalStack for Azure follows +[calendar versioning](https://calver.org/) in the `YYYY.MM.patch` format. +For example, `2026.03.0` is the initial March 2026 release. + LocalStack for Azure 0.1.0 supports the following services: - [Azure API Management](https://azure.microsoft.com/en-us/products/api-management/) diff --git a/src/content/docs/azure/getting-started/index.mdx b/src/content/docs/azure/getting-started/index.mdx index dd8f179c..5d2b0e60 100644 --- a/src/content/docs/azure/getting-started/index.mdx +++ b/src/content/docs/azure/getting-started/index.mdx @@ -78,3 +78,7 @@ $ docker-compose up To update the Azure Docker container, pull the latest image and restart the container. The `latest` tag is the nightly build of the Azure Docker image. + +Starting with the end-of-March 2026 release, versioned Azure image tags follow +[calendar versioning](https://calver.org/) in the `YYYY.MM.patch` format (for example, `2026.03.0`). +Refer to the available [tags on Docker Hub](https://hub.docker.com/r/localstack/localstack-azure-alpha/tags) for the latest releases. diff --git a/src/content/docs/snowflake/changelog.md b/src/content/docs/snowflake/changelog.md index 1a61e3e2..b8bcf519 100644 --- a/src/content/docs/snowflake/changelog.md +++ b/src/content/docs/snowflake/changelog.md @@ -7,6 +7,10 @@ editUrl: false The LocalStack for Snowflake changelog tracks updates to LocalStack’s Snowflake support, including new features, enhancements, and compatibility fixes. Stay up to date on changes across official versioned releases of LocalStack’s Snowflake support. +Starting with the end-of-March 2026 release, LocalStack for Snowflake follows +[calendar versioning](https://calver.org/) in the `YYYY.MM.patch` format. +For example, `2026.03.0` is the initial March 2026 release. + ### 1.7.0 - Add support for `OBJECT_AGG`, `QUERY_HISTORY_BY_USER`, `BOOLAND_AGG`, `BOOLOR_AGG`, `APPROX_PERCENTILE`, `LIKE`, `ILIKE`, and math functions - Add support for date arithmetics diff --git a/src/content/docs/snowflake/getting-started/index.mdx b/src/content/docs/snowflake/getting-started/index.mdx index 6ef9e3af..d82ad076 100644 --- a/src/content/docs/snowflake/getting-started/index.mdx +++ b/src/content/docs/snowflake/getting-started/index.mdx @@ -144,6 +144,9 @@ If you only want to update the Snowflake image manually (e.g. to pick up a recen docker pull localstack/snowflake:latest ``` +Starting with the end-of-March 2026 release, versioned Snowflake image tags follow +[calendar versioning](https://calver.org/) in the `YYYY.MM.patch` format (for example, `2026.03.0`). +Refer to the available [tags on Docker Hub](https://hub.docker.com/r/localstack/snowflake/tags) for the latest releases. ## Alternatives