<!--
Note: This file is primarily defined to be used in the IXP documentation.
However, it is also provided in the docker-deployment repository for reference.
If you accessed this file from the docker-deployment repository,
please be aware that the links used in this file may not work as expected.
-->

## Troubleshooting

If you encounter issues during deployment, consider the following steps:

- **Executable Permissions**:
    Ensure that the deployment scripts have executable permissions.
    Run the following command to set the appropriate permissions:

    ```
    chmod +x deploy.sh 01-substitute-env.sh
    chmod +x deploy-with-https.sh generate-cert.sh  # If using HTTPS deployment
    ```

- **INJECT_DOMAIN Setting**:
    Verify that the INJECT_DOMAIN environment variable is set to a domain name and not a static IP address.
    The platform requires a domain name to function correctly.
    For local test deployments please use reserved TLD `.localhost` (example: `inject.localhost`)

- **Backend is not returning any valid response**:
    Verify that the `INJECT_DOMAIN` and `INJECT_HOST_ADDRESSES` is set up correctly.
    The platform requires that the addresses are set up to hostnames where the platform is
    expected to be accessed from.

- **Frontend's error log in Developer Console is reporting mixed-origin connection issues**:
    Verify that connection settings in the environment variables are set up correctly.
    If using HTTP deployment, that they use `http://` and `ws://` protocol, and when using HTTPS,
    then `https://` and `wss://`.

- **Application is connecting to an incorrect backend instance**:
    Clean up your browser local storage to enforce rebinding of the Frontend client.

- **The application shows an error about frontend and backend versions not being compatible**:
    This usually happens after upgrading to a new version of the platform.
    To resolve this, clear your browser's cache to ensure that the frontend loads
    the latest version and can properly communicate with the backend.

<div class="navigation" markdown>
  [&larr; Installation overview](./overview.md){ .md-button }
</div>
