System Configuration Error (SYSTEM_CONFIGURATION_ERROR)

The runtime environment is not correctly configured. One or more required environment variables are missing or invalid.

Common causes

• Missing environment variables - An environment variable referenced in the project code or configuration is not set in the current environment.
• Wrong environment - The request is hitting an environment (such as staging or preview) where the required variables have not been configured.
• Deleted or renamed variables - An environment variable was recently deleted or renamed, but the code still references the old name.

How to check environment variables

1. Open the Zuplo portal and navigate to the project settings.
2. Review the environment variables for the target environment and verify all required variables are present.
3. Check the runtime logs for specific messages about which variable is missing.
4. Compare the environment variables across environments to find discrepancies.

How to fix

1. Identify the missing variable from the error logs.
2. Add the variable in the Zuplo portal under the project's environment variable settings.
3. Redeploy the project after adding the variable.

Related resources

• Environment Variables
• Local Development Environment Variables