Create an Azure Quantum workspace

Learn how to create an Azure Quantum workspace in the Azure portal. An Azure Quantum workspace resource, or workspace for short, is a collection of assets associated with running quantum applications.

A workspace is needed to get started with Jupyter Notebooks in the Azure portal or quantum programs on quantum hardware.


You can also create an Azure Quantum workspace using the Azure command-line interface (CLI). For more information, see Manage quantum workspaces with the Azure CLI.

Free Azure Quantum Credits

First-time users automatically get $500 (USD) free Azure Quantum Credits for use with each participating quantum hardware provider (see the full quantum provider list). Your free Azure Quantum Credits become available once you create a new Azure Quantum workspace. If you need more credits, you can apply to the Azure Quantum Credits program.


You need the following prerequisites to create a workspace.

  • An Azure account with an active subscription. Choose from one of the following subscriptions, or for a full list see Microsoft Azure Offer Details.

Register for free and sign up for a pay-as-you-go subscription. With the Azure Quantum Credits you'll have $500 (USD) to use in each quantum hardware provider. Once you've consumed all your credits, you'll only pay for the services you use and you can cancel anytime.


Note that Azure Credits and Azure Quantum Credits are different grants and shouldn't be confused. You can only use general-purpose Azure Credits with the Microsoft quantum providers - third-party providers (providers that aren't owned by Microsoft) aren't eligible.

If you have any questions or run into any issue using Azure Quantum, you can contact

Create the workspace

To create an Azure Quantum workspace, follow these steps.

  1. Sign in to the Azure portal, using the credentials for your Azure subscription.

  2. Select Create a resource and then search for Azure Quantum. On the results page, you should see a tile for the Azure Quantum service.

  3. Select Azure Quantum and then select Create. This opens a form to create a workspace.

  4. Select a subscription to associate with the new workspace.

  5. Select Quick create or Advanced create:

    Option Description
    Quick create This option is the easiest path to creating a workspace. It automatically creates the necessary resource group and storage account, adds the IonQ, Quantinuum, Rigetti, and Microsoft Quantum Computing providers, and includes free Azure Quantum Credits for IonQ, Quantinuum, and Rigetti hardware ($500 USD each). Your workspace can still be customized after creation, if needed.
    Advanced create Use this option to manually configure your resource group and storage account, select other payment options for your providers, and set tags to categorize resources. By default, this option also adds the IonQ, Quantinuum, Rigetti, and Microsoft Quantum Computing, and includes free Azure Quantum Credits for IonQ, Quantinuum, and Rigetti hardware ($500 USD each).

Note: To use Quick create, you must be an Owner of the subscription you selected in the previous step. To see a list of your subscriptions and access, see Check your role assignments.

  1. Enter a name for the workspace.
  2. Select the region for the workspace.
  3. Select Create.

Deployment of your workspace may take a few minutes. The status and deployment details will be updated in the portal.

Next steps