Troubleshoot an Enterprise deployment
Start with the service state and the relevant logs:
docker compose ps
docker compose logs --tail=100 api
Images do not download
Verify the registry credentials from your setup email, the image tags in .env, and the host's network access.
If access fails, send the error and image reference to support. Do not include the credential.
A service stays unhealthy
Read the failed service's logs. For example, for MySQL:
docker compose logs --tail=100 mysql
For database connection errors, verify the MySQL credentials and configuration.
Changing a password in .env does not change an existing MySQL account.
For Redis connection errors, inspect the service named in the error.
License validation fails
Verify your license key and access to api.keygen.sh for online validation.
For an offline installation, verify that LICENSE_FILE points to the supplied file for this host.
Include the license-file Compose override when starting services.
An invalid or expired offline file needs replacement. Contact support with the validation error.
Database migrations fail
Keep the application stopped and preserve the database and error logs.
If the log reports Timed out waiting for the database migration lock, verify that another instance is not using the database.
For other migration errors, contact support before changing database tables manually. To recover the previous release, restore its database and image together.
The site does not open
From the Docker host, verify the local HTTP endpoint. Replace the hostname with your DOMAIN_NAME:
curl -I -H 'Host: regex101.example.com' http://127.0.0.1/
docker compose logs --tail=100 nginx ssr
If you changed the published HTTP port, use that port in the command. If the local endpoint works, verify DNS and your HTTPS proxy's route to the configured HTTP port.
Sign-in is missing or fails
Verify the provider credentials, OAUTH_ORIGIN, and the registered callback URL.
For custom OpenID Connect, also verify the issuer.
After configuration changes, recreate the services.
See Sign-in setup for provider requirements.
A feature is unavailable
Verify that your Enterprise license includes the feature and that DISABLED_FEATURES does not disable it.
A public Pro subscription does not add Enterprise features.
AI Assistant is unavailable
Check the AI Assistant setup, then follow the guidance for your message:
- Access is denied: Ask your administrator to check that AI Assistant is enabled for your license.
- Sign-in is required but accounts are disabled: Enable accounts and configure sign-in, or enable anonymous assistant usage.
- The assistant is unavailable: Ask your administrator to check the provider configuration and service logs.
- The provider request fails: Ask your administrator to check the provider connection and credentials.
- The provider is busy: Wait until the indicated retry time. Your draft stays available.
Send a support report
Send the application version, failing action, service state, and relevant error excerpt to contact@regex101.com. Remove secrets and private workspace content.