Deploying to Microsoft Azure

Our recommended deployment approach in Microsoft Azure is using Helm on AKS(opens in a new tab), an Azure-managed Kubernetes(opens in a new tab) service. Alternatively, any self-managed Kubernetes flavor may be used. Refer to our Kubernetes deployment guide for more information.

Document Engine can successfully operate within other means of deployment, but we currently don’t provide documentation for alternative services.

Troubleshooting: Azure PostgreSQL extension errors

When deploying Document Engine with Azure Database for PostgreSQL Flexible Server, you might encounter extension-related errors during database migrations that cause pods to crash.

Common symptoms

You may encounter logs with errors like:

[error] ** (Postgrex.Error) ERROR 0A000 (feature_not_supported)
extension "pg_buffercache" is not allow-listed for "azure_pg_admin"
users in Azure Database for PostgreSQL

This error applies to any extension not on the allowlist, not just pg_* extensions (for example, uuid-ossp).

Resolution steps

  1. Add the required extensions to the allowlist in your Azure PostgreSQL server parameters:

    • Navigate to Azure Portal > PostgreSQL Flexible Server > Server parameters.
    • Find the azure.extensions parameter.
    • Add the missing extension names (comma-separated).

  2. Verify extensions are available by connecting to your database and running the following:

    SELECT name FROM pg_available_extensions

  3. Restart Document Engine pods to trigger migrations again:

    Terminal window
    kubectl rollout restart deployment/document-engine -n document-engine

Different versions of Document Engine may require different extensions. Check the error logs to identify which specific extensions need to be enabled.