Troubleshooting
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_DOMAINandINJECT_HOST_ADDRESSESis 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://andws://protocol, and when using HTTPS, thenhttps://andwss://. -
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.