Troubleshooting Astro integration with Azure

You can get support for your Astro deployment through a New Support request. For further assistance, visit the Astronomer Support. In addition, this article includes troubleshooting for problems you might experience in creating and using an Astro resource.

Getting support

  1. To contact support about an Astro resource, select the resource in the Resource menu.

  2. Select the Support + troubleshooting in Help menu on the left of the Overview page.

  3. Select Create a support request and fill out the details.

    Screenshot of a new Astro support ticket.


Here are some troubleshooting options to consider:

Unable to create an Astro resource as not a subscription owner/ contributor

The Astro resource can only be created by users who have Owner or Contributor access on the Azure subscription. Ensure you have the appropriate access before setting up this integration.

Marketplace purchase errors

  • The Microsoft.SaaS RP is not registered on the Azure subscription.

  • Plan cannot be purchased on a free subscription, please upgrade your account.

  • Purchase has failed because we couldn't find a valid payment method associated with your Azure subscription.

  • The Publisher does not make available Offer, Plan in your Subscription/Azure account’s region.

    • The offer or the specific plan isn't available to the billing account market that is connected to the Azure Subscription.
  • Enrollment for Azure Marketplace is set to Free/BYOL SKUs only, purchase for Azure product is not allowed. Please contact your enrollment administrator to change EA settings.

  • Marketplace is not enabled for the Azure subscription.

  • Plan by publisher is not available to you for purchase due to private marketplace settings made by your tenant’s IT administrator.

    • Customer uses private marketplace to limit the access of its organization to specific offers and plans. The specific offer or the plan weren't set up to be available in the tenant's private marketplace. Contact your tenant’s IT administrator.
  • The EA subscription doesn't allow Marketplace purchases.

    • Use a different subscription or check if your EA subscription is enabled for Marketplace purchase. For more information, see Enable Marketplace purchases.

If those options don't solve the problem, contact Astronomer support.

DeploymentFailed error

If you get a DeploymentFailed error, check the status of your Azure subscription. Make sure it isn't suspended and doesn't have any billing issues.

Resource creation takes long time

If the deployment process takes more than three hours to complete, contact support.

If the deployment fails and the Astro resource has a status of Failed, delete the resource. After deletion, try to create the resource again.

Unable to use Single sign-on

If SSO isn't working for the Astronomer portal, verify you're using the correct Microsoft Entra email. You must also have consented to allow access for the Astronomer Software as a service (SaaS) portal.


If you are seeing an Admin consent screen along with the User consent during your first-time login using the SSO Url, then please check your tenant consent settings.

For more information, see the single sign-on guidance.

Unable to install Astro using a personal email

Installing Apache Airflow on Astro from the Azure Marketplace using a personal email from a generic domain isn't supported. To install this service, use an email address with a unique domain, such as an email address associated with work or school, or start by creating a new user in Azure and make this user a subscription owner. For more information, see Install Astro from the Azure Marketplace using a personal email.

Next steps