Skip to content

Commit 07c661b

Browse files
authored
docs: add note about ports restore for persisted services (#290)
1 parent 04d9750 commit 07c661b

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

src/content/docs/aws/capabilities/state-management/persistence.mdx

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -122,6 +122,14 @@ Although we are working to support both snapshot-based persistence and Cloud pod
122122
there are some common issues, known limitations, and also services that are not well tested for persistence support.
123123
An overview is available [here](#persistence-coverage-overview).
124124

125+
:::note
126+
When using LocalStack's persistence feature, ports assigned to services (like RDS or Elasticache) when the snapshot was created may not be preserved when loading a saved state.
127+
If you start new services *before* restoring the previous state, these new instances may use ports originally used by the saved services.
128+
129+
As a result, restored resources may point to invalid or unintended ports.
130+
It is suggested to estore services in the same order as initially deployed, though this is not always reliable.
131+
:::
132+
125133
Please help us improve persistence support by reporting bugs on our [GitHub issue tracker](https://github.com/localstack/localstack/issues/new/choose).
126134

127135
## Technical Details

0 commit comments

Comments
 (0)