diff --git a/src/content/docs/snowflake/getting-started/faq.md b/src/content/docs/snowflake/getting-started/faq.md index 4b3e94c5..5c732ba5 100644 --- a/src/content/docs/snowflake/getting-started/faq.md +++ b/src/content/docs/snowflake/getting-started/faq.md @@ -44,16 +44,19 @@ If you are encountering network issues and your Snowflake client drivers are una 127.0.0.1 snowflake.localhost.localstack.cloud ``` -### Why does the Snowflake emulator say "Unable to activate license — configure a valid auth token"? +### Which Docker image tag should I use for LocalStack for Snowflake? -This message appears specifically on the Snowflake emulator image and almost always means the auth token didn't reach the container. -Confirm the variable is present inside the container: +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: -```shell -docker exec -it env | grep LOCALSTACK_AUTH_TOKEN -``` +| 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. -If the variable is empty inside the container, fix your `.env` or Compose mapping and restart. +The `nightly` tag is no longer published for LocalStack for Snowflake. Use the `dev` tag to track untagged changes from `main`. ## Support FAQs