Skip to main content

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.