Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
6b5aeed
Revamp of overview page, and structuring of other pages. No changes t…
peter-smith-phd Jul 19, 2026
3db9930
Move Remotes and State Merging sections out of cloud-pods.mdx, and sw…
peter-smith-phd Jul 20, 2026
18133c3
Move Service Coverage section out of persistence.mdx into its own page
peter-smith-phd Jul 21, 2026
3324492
Clean up the persistence.mdx page
peter-smith-phd Jul 21, 2026
94f3fe4
Fix the examples for local snapshots.
peter-smith-phd Jul 22, 2026
819afeb
WIP: rewrite Cloud Pods docs to use lstk snapshot commands
peter-smith-phd Jul 22, 2026
ead114c
WIP: rename Cloud Pods sections and fix grammar/terminology consistency
peter-smith-phd Jul 24, 2026
6bdeec3
Rename save-locally to saving-snapshots-locally.
peter-smith-phd Jul 26, 2026
8c9bd54
Updates to Cloud Pod docs
peter-smith-phd Jul 26, 2026
204d32e
WIP for saving snapshots to S3
peter-smith-phd Jul 26, 2026
3c62f98
Rename Cloud Pods page title for consistency with other snapshot pages
peter-smith-phd Jul 26, 2026
39fb0fa
Remove Cloud Pods Launchpad page from Snapshots section
peter-smith-phd Jul 30, 2026
58ad903
Rework lstk CLI examples in Cloud Pods docs
peter-smith-phd Aug 4, 2026
dde2095
Clean up index.mdx page.
peter-smith-phd Aug 4, 2026
4113823
Extract merge strategies into separate page.
peter-smith-phd Aug 4, 2026
9f145f9
Expand the saving-locally examples.
peter-smith-phd Aug 4, 2026
c41fb95
Clean up cloud pod content.
peter-smith-phd Aug 4, 2026
c23cf9f
Clean up Persistence, and fix output boxes.
peter-smith-phd Aug 4, 2026
320d3f9
clean up service-coverage
peter-smith-phd Aug 4, 2026
78ca32f
Final clean-up before code review.
peter-smith-phd Aug 4, 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
40 changes: 22 additions & 18 deletions public/_redirects
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@
/applications/appsync-graphql-apis-for-dynamodb-and-rds-aurora-postgresql/ https://github.com/localstack-samples/sample-appsync-graphql-api 301
/user-guide/aws/cloudfront/ /aws/services/cloudfront/ 301
/applications/note-taking-application-using-aws-sdk-for-javascript/ https://github.com/localstack-samples/sample-notes-app-dynamodb-lambda-apigateway 301
/user-guide/state-management/export-import-state/ /aws/developer-tools/snapshots/export-import-state/ 301
/user-guide/state-management/export-import-state/ /aws/developer-tools/snapshots/save-snapshots-locally/ 301
/references/coverage/coverage_s3control/ /aws/services/s3/ 301
/references/custom-tls-certificates/ /aws/developer-tools/security-testing/custom-tls-certificates/ 301
/references/coverage/coverage_codecommit/ /aws/services/codecommit/ 301
Expand Down Expand Up @@ -237,7 +237,7 @@
/user-guide/aws/cloudwatch/ /aws/services/cloudwatch/ 301
/user-guide/aws/elasticbeanstalk/ /aws/services/elasticbeanstalk/ 301
/references/coverage/coverage_mediaconvert/ /aws/services/mediaconvert/ 301
/user-guide/state-management/launchpad/ /aws/developer-tools/snapshots/launchpad/ 301
/user-guide/state-management/launchpad/ /aws/developer-tools/snapshots/ 301
/user-guide/ci/codebuild/ /aws/ci-pipelines/codebuild/ 301
/user-guide/aws/iot-data/ /aws/services/iot-data/ 301
/references/coverage/coverage_textract/ /aws/services/textract/ 301
Expand Down Expand Up @@ -379,7 +379,7 @@
/user-guide/aws/stepfunctions/ /aws/services/stepfunctions/ 301
/references/coverage/coverage_elasticache/ /aws/services/elasticache/ 301
/applications/mnist-handwritten-digit-recognition-model-running-on-a-local-sagemaker-endpoint/ https://github.com/localstack-samples/sample-mnist-digit-recognition-sagemaker 301
/user-guide/state-management/pods-cli/ /aws/developer-tools/snapshots/cli-commands/ 301
/user-guide/state-management/pods-cli/ /aws/developer-tools/running-localstack/lstk/#snapshot 301
/user-guide/aws/dynamodbstreams/ /aws/services/dynamodbstreams/ 301
/references/api-key/ /aws/getting-started/auth-token/#how-do-i-activate-older-versions-of-localstack-before-v30/ 301
/references/coverage/coverage_eks/ /aws/services/eks/ 301
Expand Down Expand Up @@ -430,7 +430,7 @@
/applications/appsync-graphql-apis-for-dynamodb-and-rds-aurora-postgresql https://github.com/localstack-samples/sample-appsync-graphql-api 301
/user-guide/aws/cloudfront /aws/services/cloudfront/ 301
/applications/note-taking-application-using-aws-sdk-for-javascript https://github.com/localstack-samples/sample-notes-app-dynamodb-lambda-apigateway 301
/user-guide/state-management/export-import-state /aws/developer-tools/snapshots/export-import-state/ 301
/user-guide/state-management/export-import-state /aws/developer-tools/snapshots/save-snapshots-locally/ 301
/references/coverage/coverage_s3control /aws/services/s3/ 301
/references/custom-tls-certificates /aws/developer-tools/security-testing/custom-tls-certificates/ 301
/references/coverage/coverage_codecommit /aws/services/codecommit/ 301
Expand Down Expand Up @@ -637,7 +637,7 @@
/user-guide/aws/cloudwatch /aws/services/cloudwatch/ 301
/user-guide/aws/elasticbeanstalk /aws/services/elasticbeanstalk/ 301
/references/coverage/coverage_mediaconvert /aws/services/mediaconvert/ 301
/user-guide/state-management/launchpad /aws/developer-tools/snapshots/launchpad/ 301
/user-guide/state-management/launchpad /aws/developer-tools/snapshots/ 301
/user-guide/ci/codebuild /aws/ci-pipelines/codebuild/ 301
/user-guide/aws/iot-data /aws/services/iot-data/ 301
/references/coverage/coverage_textract /aws/services/textract/ 301
Expand Down Expand Up @@ -779,7 +779,7 @@
/user-guide/aws/stepfunctions /aws/services/stepfunctions/ 301
/references/coverage/coverage_elasticache /aws/services/elasticache/ 301
/applications/mnist-handwritten-digit-recognition-model-running-on-a-local-sagemaker-endpoint https://github.com/localstack-samples/sample-mnist-digit-recognition-sagemaker 301
/user-guide/state-management/pods-cli /aws/developer-tools/snapshots/cli-commands/ 301
/user-guide/state-management/pods-cli /aws/developer-tools/running-localstack/lstk/#snapshot 301
/user-guide/aws/dynamodbstreams /aws/services/dynamodbstreams/ 301
/references/api-key /aws/getting-started/auth-token/#how-do-i-activate-older-versions-of-localstack-before-v30/ 301
/references/coverage/coverage_eks /aws/services/eks/ 301
Expand Down Expand Up @@ -861,13 +861,17 @@
/aws/integrations/aws-native-tools /aws/connecting/ 301
/aws/integrations/infrastructure-as-code/ /aws/connecting/infrastructure-as-code/ 301
/aws/integrations/infrastructure-as-code /aws/connecting/infrastructure-as-code/ 301
/aws/capabilities/state-management/cli-commands /aws/developer-tools/snapshots/cli-commands/ 301
/aws/capabilities/state-management/cli-commands/ /aws/developer-tools/snapshots/cli-commands/ 301
/aws/capabilities/state-management/export-import-state /aws/developer-tools/snapshots/export-import-state/ 301
/aws/capabilities/state-management/export-import-state/ /aws/developer-tools/snapshots/export-import-state/ 301
/aws/capabilities/state-management/cli-commands /aws/developer-tools/running-localstack/lstk/#snapshot 301
/aws/capabilities/state-management/cli-commands/ /aws/developer-tools/running-localstack/lstk/#snapshot 301
/aws/capabilities/state-management/export-import-state /aws/developer-tools/snapshots/save-snapshots-locally/ 301
/aws/capabilities/state-management/export-import-state/ /aws/developer-tools/snapshots/save-snapshots-locally/ 301
/aws/capabilities/state-management/ /aws/developer-tools/snapshots/ 301
/aws/capabilities/state-management/launchpad /aws/developer-tools/snapshots/launchpad/ 301
/aws/capabilities/state-management/launchpad/ /aws/developer-tools/snapshots/launchpad/ 301
/aws/developer-tools/snapshots/export-import-state /aws/developer-tools/snapshots/save-snapshots-locally/ 301
/aws/developer-tools/snapshots/export-import-state/ /aws/developer-tools/snapshots/save-snapshots-locally/ 301
/aws/developer-tools/snapshots/cli-commands /aws/developer-tools/running-localstack/lstk/#snapshot 301
/aws/developer-tools/snapshots/cli-commands/ /aws/developer-tools/running-localstack/lstk/#snapshot 301
/aws/capabilities/state-management/launchpad /aws/developer-tools/snapshots/ 301
/aws/capabilities/state-management/launchpad/ /aws/developer-tools/snapshots/ 301
/aws/capabilities/state-management/cloud-pods /aws/developer-tools/snapshots/cloud-pods/ 301
/aws/capabilities/state-management/cloud-pods/ /aws/developer-tools/snapshots/cloud-pods/ 301
/aws/capabilities/state-management/persistence /aws/developer-tools/snapshots/persistence/ 301
Expand Down Expand Up @@ -1070,14 +1074,14 @@
/aws/configuration/security-testing/iam-policy-stream /aws/developer-tools/security-testing/iam-policy-stream/ 301
/aws/configuration/security-testing/iam-policy-stream/ /aws/developer-tools/security-testing/iam-policy-stream/ 301
/aws/configuration/state-management/ /aws/developer-tools/snapshots/ 301
/aws/configuration/state-management/cli-commands /aws/developer-tools/snapshots/cli-commands/ 301
/aws/configuration/state-management/cli-commands/ /aws/developer-tools/snapshots/cli-commands/ 301
/aws/configuration/state-management/cli-commands /aws/developer-tools/running-localstack/lstk/#snapshot 301
/aws/configuration/state-management/cli-commands/ /aws/developer-tools/running-localstack/lstk/#snapshot 301
/aws/configuration/state-management/cloud-pods /aws/developer-tools/snapshots/cloud-pods/ 301
/aws/configuration/state-management/cloud-pods/ /aws/developer-tools/snapshots/cloud-pods/ 301
/aws/configuration/state-management/export-import-state /aws/developer-tools/snapshots/export-import-state/ 301
/aws/configuration/state-management/export-import-state/ /aws/developer-tools/snapshots/export-import-state/ 301
/aws/configuration/state-management/launchpad /aws/developer-tools/snapshots/launchpad/ 301
/aws/configuration/state-management/launchpad/ /aws/developer-tools/snapshots/launchpad/ 301
/aws/configuration/state-management/export-import-state /aws/developer-tools/snapshots/save-snapshots-locally/ 301
/aws/configuration/state-management/export-import-state/ /aws/developer-tools/snapshots/save-snapshots-locally/ 301
/aws/configuration/state-management/launchpad /aws/developer-tools/snapshots/ 301
/aws/configuration/state-management/launchpad/ /aws/developer-tools/snapshots/ 301
/aws/configuration/state-management/persistence /aws/developer-tools/snapshots/persistence/ 301
/aws/configuration/state-management/persistence/ /aws/developer-tools/snapshots/persistence/ 301
/aws/configuration/testing-utils/ /aws/customization/integrations/localstack-sdks/testing-utils/ 301
Expand Down
Binary file removed public/images/aws/badge-demo.png
Binary file not shown.
Binary file removed public/images/aws/link-generator.png
Binary file not shown.
Binary file removed public/images/aws/ls-not-running.png
Binary file not shown.
Binary file removed public/images/aws/merge-strategies.png
Binary file not shown.
Binary file removed public/images/aws/metadata-load-failed.png
Binary file not shown.
Binary file removed public/images/aws/persistence-pods-remote.png
Binary file not shown.
Binary file added public/images/aws/pods-workflow.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/images/aws/snapshot-merge-service.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions src/content/docs/aws/ci-pipelines/circleci.md
Original file line number Diff line number Diff line change
Expand Up @@ -520,7 +520,7 @@ jobs:
- localstack-load-state
```

More information about Localstack's [state import/export](/aws/developer-tools/snapshots/export-import-state).
More information about Localstack's [state import/export](/aws/developer-tools/snapshots/saving-snapshots-locally).

#### Cache

Expand Down Expand Up @@ -586,4 +586,4 @@ workflows:
...
```

More information about [state management](/aws/developer-tools/snapshots/export-import-state).
More information about [state management](/aws/developer-tools/snapshots/saving-snapshots-locally).
4 changes: 2 additions & 2 deletions src/content/docs/aws/ci-pipelines/codebuild.md
Original file line number Diff line number Diff line change
Expand Up @@ -241,7 +241,7 @@ Find out more about [ephemeral instances](/aws/developer-tools/cloud-sandbox/eph

#### Artifact

Find out more about [state management](/aws/developer-tools/snapshots/export-import-state/).
Find out more about [state management](/aws/developer-tools/snapshots/saving-snapshots-locally/).

```yml showshowLineNumbers
...
Expand Down Expand Up @@ -274,7 +274,7 @@ To use previously stored artifacts as inputs, set them as a source in the projec

#### Cache

Additional information about [state export and import](/aws/developer-tools/snapshots/export-import-state/).
Additional information about [state export and import](/aws/developer-tools/snapshots/saving-snapshots-locally/).

##### Native Runner

Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/aws/ci-pipelines/github-actions.md
Original file line number Diff line number Diff line change
Expand Up @@ -171,7 +171,7 @@ Find out more about ephemeral instances [here](/aws/developer-tools/cloud-sandbo
...
```

More information about state import and export [here](/aws/developer-tools/snapshots/export-import-state).
More information about state import and export [here](/aws/developer-tools/snapshots/saving-snapshots-locally).

## Current Limitations

Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/aws/ci-pipelines/gitlab-ci.md
Original file line number Diff line number Diff line change
Expand Up @@ -136,7 +136,7 @@ job:
...
```

More info about Localstack's state export and import [here](/aws/developer-tools/snapshots/export-import-state/).
More info about Localstack's state export and import [here](/aws/developer-tools/snapshots/saving-snapshots-locally/).

#### Cache

Expand All @@ -159,7 +159,7 @@ job:
...
```

Additional information about state export and import [here](/aws/developer-tools/snapshots/export-import-state/).
Additional information about state export and import [here](/aws/developer-tools/snapshots/saving-snapshots-locally/).

#### Cloud Pod

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -117,7 +117,7 @@ A common use case for init hooks is pre-seeding LocalStack with custom state.
For example if you want to have a certain S3 bucket or DynamoDB table created when starting LocalStack, init hooks can be very useful.

:::tip
If you have more complex states, [Cloud Pods](/aws/developer-tools/snapshots/cloud-pods) and [how to auto-load them on startup](/aws/developer-tools/snapshots/cloud-pods#auto-loading-cloud-pods) may be a good option to look into!
If you have more complex states, [Cloud Pods](/aws/developer-tools/snapshots/cloud-pods) and [how to auto-load them on startup](/aws/developer-tools/snapshots/cloud-pods#auto-loading-from-cloud-pods) may be a good option to look into!
:::

To execute aws cli commands when LocalStack becomes ready,
Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/aws/customization/configuration-options.md
Original file line number Diff line number Diff line change
Expand Up @@ -403,7 +403,7 @@ To learn more about these configuration options, see [Persistence](/aws/develope
| `SNAPSHOT_SAVE_STRATEGY` | `ON_SHUTDOWN`\|`ON_REQUEST`\|`SCHEDULED`\|`MANUAL` | Strategy that governs when LocalStack should make state snapshots |
| `SNAPSHOT_LOAD_STRATEGY` | `ON_STARTUP`\|`ON_REQUEST`\|`MANUAL` | Strategy that governs when LocalStack restores state snapshots |
| `SNAPSHOT_FLUSH_INTERVAL` | 15 (default) | The interval (in seconds) between persistence snapshots. It only applies to a `SCHEDULED` save strategy (see [Persistence Mechanism](/aws/developer-tools/snapshots/persistence))|
| `DISABLE_COMPATIBILITY_RULES` | `0` (default) \| `1` | Disable the [state compatibility rules](/aws/developer-tools/snapshots/persistence#state-compatibility) that prevent loading incompatible state into LocalStack. Applies to both snapshot persistence and Cloud Pods. |
| `DISABLE_COMPATIBILITY_RULES` | `0` (default) \| `1` | Disable the [snapshot compatibility rules](/aws/developer-tools/snapshots/service-coverage#snapshot-compatibility) that prevent loading incompatible state into LocalStack. Applies to both snapshot persistence and Cloud Pods. |

## Cloud Pods

Expand All @@ -415,7 +415,7 @@ To learn more about these configuration options, see [Cloud Pods](/aws/developer
| `POD_LOAD_CLI_TIMEOUT` | 60 (default) | Timeout in seconds to wait before returning from load operations on the Cloud Pods CLI |
| `POD_ENCRYPTION` | `0` (default) \| `1` | Whether to encrypt the Cloud Pods artifacts at rest. |
| `ENABLE_POD_RESOURCES=1` | `0` (default) \| `1` | Whether to save a detailed Stack Overview including available resources for the Cloud Pod |
| `MERGE_STRATEGY` | `account-region-merge` (default) \| `service-merge` \| `overwrite` | The merge strategy to apply when loading a Cloud Pod into LocalStack (see [state merging](/aws/developer-tools/snapshots/cloud-pods/#state-merging)) |
| `MERGE_STRATEGY` | `account-region-merge` (default) \| `service-merge` \| `overwrite` | The merge strategy to apply when loading a Cloud Pod into LocalStack (see [merging snapshots](/aws/developer-tools/snapshots/merging-snapshots/)) |

## Extensions

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ The main integrations are:

- **License activation**: The standard image performs online activation using your `LOCALSTACK_AUTH_TOKEN`. See [Auth Token](/aws/getting-started/auth-token) for activation behavior and fallbacks.
- **Event reporting (telemetry)**: Used for Stack Insights and related usage analytics. You can disable this via `DISABLE_EVENTS=1`.
- **Cloud Pods (platform remote)**: Saving/loading pods against the default platform remote uses LocalStack-managed infrastructure. For stricter data residency, configure your own Cloud Pods [remote storage](/aws/developer-tools/snapshots/cloud-pods#remotes).
- **Cloud Pods (platform remote)**: Saving/loading pods against the default platform remote uses LocalStack-managed infrastructure. For stricter data residency, consider other [remote storage options](/aws/developer-tools/snapshots/saving-snapshots-to-s3).
- **Ephemeral instances**: These are managed cloud instances and therefore require connectivity to LocalStack Cloud services.

### Recommended setup for offline environments
Expand Down
Loading
Loading