Tutorial: Prepare to deploy Azure Stack Edge Pro R

This tutorial is the first in the series of deployment tutorials that are required to completely deploy Azure Stack Edge Pro R. This tutorial describes how to prepare the Azure portal to deploy an Azure Stack Edge resource. The tutorial uses a 1-node Azure Stack Edge Pro R device shipped with an Uninterruptible Power Supply (UPS).

You need administrator privileges to complete the setup and configuration process. The portal preparation takes less than 10 minutes.

In this tutorial, you learn how to:

  • Create a new resource
  • Get the activation key

Get started

To deploy Azure Stack Edge Pro R, refer to the following tutorials in the prescribed sequence.

To do this step Use these documents
Preparation These steps must be completed in preparation for the upcoming deployment.
Deployment configuration checklist Use this checklist to gather and record information before and during the deployment.
Deployment prerequisites These prerequisites validate the environment is ready for deployment.
Deployment tutorials These tutorials are required to deploy your Azure Stack Edge Pro R device in production.
1. Prepare the Azure portal for device Create and configure your Azure Stack Edge resource before you install an Azure Stack Box Edge physical device.
2. Install the device Inspect and cable your physical device.
3. Connect to the device Once the device is installed, connect to device local web UI.
4. Configure network settings Configure network including the compute network and web proxy settings for your device.
5. Configure device settings Assign a device name and DNS domain, configure update server and device time.
6. Configure security settings Configure certificates, VPN, encryption-at-rest for your device. Use device generated certificates or bring your own certificates.
7. Activate the device Use the activation key from service to activate the device. The device is ready to set up SMB or NFS shares or connect via REST.
8. Configure compute Configure the compute role on your device. A Kubernetes cluster is also created.

You can now begin to set up the Azure portal.

Deployment configuration checklist

Before you deploy your device, you need to collect information to configure the software on your Azure Stack Edge Pro device. Preparing some of this information ahead of time helps streamline the process of deploying the device in your environment. Use the Azure Stack Edge Pro R deployment configuration checklist to note down the configuration details as you deploy your device.


Following are the configuration prerequisites for your Azure Stack Edge resource, your Azure Stack Edge device, and the datacenter network.

For the Azure Stack Edge resource

Before you begin, make sure that:

  • Your Microsoft Azure subscription is enabled for an Azure Stack Edge resource. Make sure that you used a supported subscription such as Microsoft Enterprise Agreement (EA), Cloud Solution Provider (CSP), or Microsoft Azure Sponsorship.

  • You have owner or contributor access at resource group level for the Azure Stack Edge/Azure Storage Gateway, IoT Hub, and Azure Storage resources.

    • To create any Azure Stack Edge resource, you should have permissions as a contributor (or higher) scoped at resource group level. You also need to make sure that the Microsoft.DataBoxEdge provider is registered. For information on how to register, go to Register resource provider.
    • To create any IoT Hub resource, make sure that Microsoft.Devices provider is registered. For information on how to register, go to Register resource provider.
    • To create a Storage account resource, again you need contributor or higher access scoped at the resource group level. Azure Storage is by default a registered resource provider.
  • You have admin or user access to Azure¬†Active Directory Graph API. For more information, see Azure Active Directory Graph API.

  • You have your Microsoft Azure storage account with access credentials.

For the Azure Stack Edge device

Before you deploy a physical device, make sure that:

  • You have received the physical device.
  • You have access to a flat, stable, and level work surface where the device can rest safely.
  • The site where you intend to set up the device has standard AC power from an independent source or a rack power distribution unit (PDU).

For the datacenter network

Before you begin, make sure that:

  • The network in your datacenter is configured per the networking requirements for your Azure Stack Edge device. For more information, see Azure Stack Edge Pro R System Requirements.

  • For normal operating conditions of your device, you have:

    • A minimum of 10-Mbps download bandwidth to ensure the device stays updated.
    • A minimum of 20-Mbps dedicated upload and download bandwidth to transfer files.

Create a new resource

If you have an existing Azure Stack Edge resource to manage your physical device, skip this step and go to Get the activation key.

To create an Azure Stack Edge resource, take the following steps in the Azure portal.

  1. Use your Microsoft Azure credentials to sign in to the Azure portal at this URL: https://portal.azure.com.

  2. In the left-pane, select + Create a resource. Search for and select Azure Stack Edge / Data Box Gateway. Select Create.

  3. Pick the subscription that you want to use for the Azure Stack Edge Pro device. Select the country to where you want to ship this physical device. Select Show devices.

    Create a resource 1

  4. Select device type. Under Azure Stack Edge, choose Azure Stack Edge Pro R and then choose Select. If you see any issues or are unable to select the device type, go to Troubleshoot order issues.

    Create a resource 2

  5. Based on your business need, you can select Azure Stack Edge Pro R single node or Azure Stack Edge Pro R single node with UPS.

    Create a resource 3

  6. On the Basics tab, enter or select the following Project details.

    Setting Value
    Subscription The subscription is automatically populated based on the earlier selection. Subscription is linked to your billing account.
    Resource group Select an existing group or create a new group.
    Learn more about Azure Resource Groups.
  7. Enter or select the following Instance details.

    Setting Value
    Name A friendly name to identify the resource.
    The name has between 2 and 50 characters containing letter, numbers, and hyphens.
    Name starts and ends with a letter or a number.
    Region For a list of all the regions where the Azure Stack Edge resource is available, see Azure products available by region. If using Azure Government, all the government regions are available as shown in the Azure regions.
    Choose a location closest to the geographical region where you want to deploy your device.

    Create a resource 4

  8. Select Next: Shipping address.

    • If you already have a device, select the combo box for I have a Azure Stack Edge Pro R device.

      Create a resource 5

    • If this device is the new device that you're ordering, enter the contact name, company, address to ship the device, and contact information.

      Create a resource 6

  9. Select Next: Tags. Optionally provide tags to categorize resources and consolidate billing. Select Next: Review + create.

  10. On the Review + create tab, review the Pricing details, Terms of use, and the details for your resource. Select the combo box for I have reviewed the privacy terms.

    Create a resource 7

    You are also notified that during the resource creation, a Managed Service Identity (MSI) is enabled that lets you authenticate to cloud services. This identity exists for as long as the resource exists.

  11. Select Create.

    The resource creation takes a few minutes. An MSI is also created that lets the Azure Stack Edge device communicate with the resource provider in Azure.

    After the resource is successfully created and deployed, you're notified. Select Go to resource.

    Go to the Azure Stack Edge Pro resource

After the order is placed, Microsoft reviews the order and contacts you (via email) with shipping details.


If you want to create multiple orders at one time or clone an existing order, you can use the scripts in Azure Samples. For more information, see the README file.

If you run into any issues during the order process, see Troubleshoot order issues.

Get the activation key

After the Azure Stack Edge resource is up and running, you'll need to get the activation key. This key is used to activate and connect your Azure Stack Edge Pro device with the resource. You can get this key now while you are in the Azure portal.

  1. Select the resource that you created, and select Overview.

  2. In the right pane, provide a name for the Azure Key Vault or accept the default name. The key vault name can be between 3 and 24 characters.

    A key vault is created for each Azure Stack Edge resource that is activated with your device. The key vault lets you store and access secrets, for example, the Channel Integrity Key (CIK) for the service is stored in the key vault.

    Once you've specified a key vault name, select Generate activation key to create an activation key.

    Get activation key

    Wait a few minutes while the key vault and activation key are created. Select the copy icon to copy the key and save it for later use.


  • The activation key expires three days after it is generated.
  • If the key has expired, generate a new key. The older key is not valid.

Next steps

In this tutorial, you learned about Azure Stack Edge topics such as:

  • Create a new resource
  • Get the activation key

Advance to the next tutorial to learn how to install Azure Stack Edge.