You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/docs/aws/customization/configuration-options.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,7 +29,7 @@ Options that affect the core LocalStack system.
29
29
|`DEBUG`|`0` (default) \|`1`| Flag to increase log level and print more verbose logs (useful for troubleshooting issues)|
30
30
|`IMAGE_NAME`|`localstack/localstack` (default), `localstack/localstack:0.11.0`| Specific name and tag of LocalStack Docker image to use.|
31
31
|`LOCALSTACK_HOST`|`localhost.localstack.cloud:4566` (default) | This is interpolated into URLs and addresses that are returned by LocalStack. It has the form `<hostname>:<port>`. |
32
-
|`GATEWAY_LISTEN`|`0.0.0.0:4566` (default in Docker mode), `127.0.0.1:4566` (default in host mode) | Configures the bind addresses of LocalStack. It has the form `<ip address>:<port>(,<ip address>:<port>)*`. LocalStack for AWS adds port `443`. |
32
+
|`GATEWAY_LISTEN`|`0.0.0.0:4566,0.0.0.0:443` (default in Docker mode), `127.0.0.1:4566,127.0.0.1:443` (default in host mode) | Configures the bind addresses of LocalStack. It has the form `<ip address>:<port>(,<ip address>:<port>)*`. When unset, LocalStack listens on both the HTTP edge port (`4566`) and HTTPS (`443`). |
33
33
|`USE_SSL`|`0` (default) | Whether to return URLs using HTTP (`0`) or HTTPS (`1`). Changed with 3.0.0. In earlier versions this was toggling SSL support on or off. |
34
34
|`PERSISTENCE`|`0` (default) | Enable persistence. See [Persistence Mechanism](/aws/developer-tools/snapshots/persistence) and [Filesystem Layout](/aws/customization/advanced/filesystem). |
35
35
|`MAIN_CONTAINER_NAME`|`localstack-main` (default) | Specify the main docker container name |
@@ -462,7 +462,6 @@ To learn more about these configuration options, see [DNS Server](/aws/customiza
|`ACTIVATE_PRO`|`0`\|`1` (default) | Whether Pro should be activated or not. This is set to true by default if using the `localstack/localstack-pro` container image. If set to `1`, LocalStack will fail to start if the license key activation did not work. If set to `0`, an attempt is made to start LocalStack without Pro features. |
466
465
|`LOCALSTACK_AUTH_TOKEN`||[Auth token](/aws/getting-started/auth-token) to activate LocalStack for AWS. |
467
466
|`LOCALSTACK_API_KEY`||**Deprecated since 3.0.0** API key to activate LocalStack for AWS.<br/> **Use the `LOCALSTACK_AUTH_TOKEN` instead (except for [CI environments](/aws/ci-pipelines/)).**|
468
467
|`LOG_LICENSE_ISSUES`|`0`\|`1` (default) | Whether to log issues with the license activation to the console. |
@@ -476,6 +475,7 @@ These configurations have already been removed and **won't have any effect** on
476
475
477
476
| Variable | Removed in | Example Values | Description |
478
477
| - | - | - | - |
478
+
|`ACTIVATE_PRO`| 2026.7.0 |`0`\|`1` (default) | Whether Pro should be activated or not. Previously allowed starting LocalStack without Pro features when set to `0`. The flag had no remaining effect and was removed; use the community image (`localstack/localstack`) if you do not need Pro features. |
479
479
|`EVENT_RULE_ENGINE`| 4.1.0 |`python` (default) \|`java` (deprecated) | Engine for [event pattern matching](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns-content-based-filtering.html) used in EventBridge, EventBridge Pipes, and Lambda Event Source Mapping. Our new `python` implementation introduced with version `4.0.3` makes the `java` engine (previously in preview) using AWS [event-ruler](https://github.com/aws/event-ruler) obsolete. |
480
480
|`LAMBDA_EVENT_SOURCE_MAPPING`| 4.0.0 |`v2` (default since [3.8.0](https://blog.localstack.cloud/localstack-release-v-3-8-0/#new-default-lambda-event-source-mapping-implementation)) \|`v1`| Feature flag to switch Lambda Event Source Mapping (ESM) implementations. |
481
481
|`PROVIDER_OVERRIDE_STEPFUNCTIONS`| 4.0.0 |`v2` (default) \|`legacy`| The new LocalStack-native StepFunctions provider (v2) is active by default since LocalStack 3.0. |
Reason: The credentials defined in your environment are invalid. Please make sure to either set the LOCALSTACK_AUTH_TOKEN variable to a valid auth token, or the LOCALSTACK_API_KEY variable to a valid LocalStack API key. You can find your Auth Token or API key in the LocalStack web app https://app.localstack.cloud.
237
237
238
-
Due to this error, Localstack has quit. LocalStack for AWS features can only be used with a valid license.
238
+
Due to this error, Localstack has quit. LocalStack pro features can only be used with a valid license.
239
239
240
240
- Please check that your credentials are set up correctly and that you have an active license.
241
241
You can find your credentials in our webapp at https://app.localstack.cloud.
242
-
- If you want to continue using LocalStack without pro features you can set `ACTIVATE_PRO=0`.
243
242
```
244
243
245
244
The key activation in LocalStack may fail for several reasons, and the most common ones are listed below in this section.
| `ACTIVATE_PRO` | `0` to start LocalStack without Pro features (lets the container boot even if license activation fails) |
703
702
704
703
For the full configuration reference, see the [Configuration reference](/aws/customization/configuration-options/) and the broader [Networking documentation](/aws/customization/networking/).
0 commit comments