.. _environment_variables:

.. role:: raw-html(raw)
    :format: html

=======================
Environment Variables
=======================

The following is a non-exhaustive list of the environment variables that can be used to configure Moto.



+-------------------------------+----------+-----------+-------------------------------------------------------------------------------------------------+
| Key                           | Value    | Default   | Explanation                                                                                     |
+===============================+==========+===========+=================================================================================================+
| TEST_SERVER_MODE              | bool     | False     | Useful when you want to run decorated tests against an existing MotoServer.  :raw-html:`<br />` |
|                               |          |           | All boto3-clients/resources created within the test will point to `http://localhost:5000`.      |
+-------------------------------+----------+-----------+-------------------------------------------------------------------------------------------------+
| INITIAL_NO_AUTH_ACTION_COUNT  | int      | 0         | See :ref:`iam access control`.                                                                  |
+-------------------------------+----------+-----------+-------------------------------------------------------------------------------------------------+
| DEFAULT_CONTAINER_REGISTRY    | str      | docker.io | Registry that contains the Docker containers.  :raw-html:`<br />`                               |
|                               |          |           | Used by AWSLambda and Batch.                                                                    |
+-------------------------------+----------+-----------+-------------------------------------------------------------------------------------------------+
| MOTO_ALLOW_NONEXISTENT_REGION | bool     | False     |                                                                                                 |
+-------------------------------+----------+-----------+-------------------------------------------------------------------------------------------------+
| MOTO_ENABLE_ISO_REGIONS       | bool     | False     | Enable the mocking of ISO regions (ISO, ISO-B, ISO-E, ISO-F)                                    |
+-------------------------------+----------+-----------+-------------------------------------------------------------------------------------------------+
|                               |          |           |                                                                                                 |
+-------------------------------+----------+-----------+-------------------------------------------------------------------------------------------------+
| MOTO_EVENTS_INVOKE_HTTP       | str      |           | See :ref:`events`.                                                                              |
+-------------------------------+----------+-----------+-------------------------------------------------------------------------------------------------+
| MOTO_S3_CUSTOM_ENDPOINTS      | str      |           | See :ref:`s3`.                                                                                  |
+-------------------------------+----------+-----------+-------------------------------------------------------------------------------------------------+
| MOTO_S3_DEFAULT_MAX_KEYS      | str      |           | See :ref:`s3`.                                                                                  |
+-------------------------------+----------+-----------+-------------------------------------------------------------------------------------------------+
| S3_IGNORE_SUBDOMAIN_BUCKETNAME| str      |           | See :ref:`s3`.                                                                                  |
+-------------------------------+----------+-----------+-------------------------------------------------------------------------------------------------+
| MOTO_PRETTIFY_RESPONSES       | bool     | False     | Prettify responses from Moto, making it easier to read and debug.                               |
+-------------------------------+----------+-----------+-------------------------------------------------------------------------------------------------+
| MOTO_DISABLE_GLOBAL_CORS      | bool     | False     | Disable configuring global wildcard CORS.                                                       |
+-------------------------------+----------+-----------+-------------------------------------------------------------------------------------------------+