Skip to content

docs(snowflake): add FAQ entry on Docker image tags #712

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
quetzalliwrites merged 2 commits into from
Jun 24, 2026
+10 −7
Merged

docs(snowflake): add FAQ entry on Docker image tags #712

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
13a8c25
docs(snowflake): add FAQ entry on Docker image tags
HarshCasper Jun 16, 2026
36942ed
Merge branch 'main' into doc-290-doc-ci-update-snowflake-workflows-to…
quetzalliwrites Jun 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 10 additions & 7 deletions src/content/docs/snowflake/getting-started/faq.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 <container-id> 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

Expand Down