From 13a8c256145014ac90758b62b8e5f2d5dc4ccd59 Mon Sep 17 00:00:00 2001 From: Harsh Mishra Date: Tue, 16 Jun 2026 15:35:28 +0530 Subject: [PATCH] docs(snowflake): add FAQ entry on Docker image tags --- src/content/docs/snowflake/getting-started/faq.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/src/content/docs/snowflake/getting-started/faq.md b/src/content/docs/snowflake/getting-started/faq.md index 711a80c10..5c732ba55 100644 --- a/src/content/docs/snowflake/getting-started/faq.md +++ b/src/content/docs/snowflake/getting-started/faq.md @@ -44,6 +44,20 @@ If you are encountering network issues and your Snowflake client drivers are una 127.0.0.1 snowflake.localhost.localstack.cloud ``` +### Which Docker image tag should I use for LocalStack for Snowflake? + +As of the LocalStack for Snowflake 2026.05.0 release, the published Docker image tags follow the same policy used across the wider LocalStack image set: + +| Tag | Updated when | Recommended for | +|---|---|---| +| `latest` / `stable` | Tagged releases only (e.g. `2026.05.0`) | Most users, stable, release-quality builds | +| `dev` | Every merged commit on `main` (the main development branch) | Users who need the latest unreleased changes | +| `YYYY.MM.patch` (e.g. `2026.05.0`) | Never (pinned) | Fully reproducible environments where no changes are acceptable | + +Previously, `latest` tracked untagged changes from `main`. It now mirrors `stable` and is only updated on official tagged releases. If you were relying on `localstack/snowflake:latest` to pick up the most recent unreleased changes (for example, in CI or Docker Compose), switch to the `dev` tag instead. + +The `nightly` tag is no longer published for LocalStack for Snowflake. Use the `dev` tag to track untagged changes from `main`. + ## Support FAQs ### How can I get help or support with LocalStack for Snowflake?