How to Install the Azure Stack Development Toolkit (ASDK)

Save to My DOJO

How to Install the Azure Stack Development Toolkit (ASDK)

What is the Azure Stack Hub Development Kit (ASDK)? In the last article we discussed hybrid cloud scenarios and the differences between private, public and hybrid clouds. We already have had a look on how cloud in general work and why you should use cloud services instead of setting up local environments, often called private clouds. In this article we’ll be diving deeper into how you can test Azure Stack yourself.

Azure Stack Refresher

With Microsoft Azure there are worldwide cloud services available within more than 50 regions and +150 datacenters, exclusively connected using the Microsoft owned backbone. But if there are scenarios where you explicitly need cloud services on-premises, Microsoft is offering Microsoft Azure Stack Hub. This is a downsized version of Azure using the same stack of technologies that they are running in public Azure but on a smaller footprint (4-12 servers in one rack). Originally there was only one Azure Stack, but since then there are a few members of the family, here we’re talking about Azure Stack Hub, the new name for Azure Stack. There’s also Azure Stack HCI which is built on a custom version of Windows Server, supports full access to the hardware (unlike Azure Stack Hub) and Azure Stack Edge for edge computing workloads. 

Microsoft Azure Stack Hub is bound to hardware that has been tested and certified for it. The hardware vendors are:

  • HPE
  • Lenovo
  • Cisco
  • Huawai
  • Wortmann
  • Fujitsu

The typical scenarios for Azure Stack Hub are:

  • Disconnected/Edge Scenarios (e.g. running Azure Services on a ship or a plane)
  • Data privacy reasons (data cannot leave the company location)
  • Modern Cloud App Development on premise

As I already mentioned above, Azure Stack Hub software and hardware must be bought as an appliance, or so-called “integrated environment”. There is no software download for Azure Stack Hub available with Microsoft. But for testing (PoC) purposes, it is not a good idea to order 4-12 servers and later decide if this decision was suitable. Therefore, Microsoft offers a trial version of Azure Stack, called the “Azure Stack Hub Development Toolkit (ASDK)”. It is not bound to any physical hardware vendor, does not provide any high availability or performance but you could download and install it yourself for test/dev scenarios.

Hardware Requirements for the Azure Stack Development Kit

The ASDK requirements for an ASDK Azure Stack Hub host and to prepare ASDK host computer and ASDK architecture are as follows:

Component Minimum Recommended
Disk drives: Operating System 1 OS disk with minimum of 200 GB available for system partition (SSD or HDD) 1 OS disk with minimum of 200 GB available for system partition (SSD or HDD)
Disk drives: General development kit data* 4 disks. Each disk provides a minimum of 140 GB of capacity (SSD or HDD). All available disks are used. 4 disks. Each disk provides a minimum of 250 GB of capacity (SSD or HDD). All available disks are used.
Compute: CPU Dual-Socket: 12 Physical Cores (total) Dual-Socket: 16 Physical Cores (total)
Compute: Memory 96 GB RAM 128 GB RAM (This is the minimum to support PaaS resource providers.)
Compute: BIOS Hyper-V Enabled (with SLAT support) Hyper-V Enabled (with SLAT support)
Network: NIC Windows Server 2012 R2 Certification required for NIC; no specialized features required Windows Server 2012 R2 Certification required for NIC; no specialized features required
HW logo certification Certified for Windows Server 2012 R2 Certified for Windows Server 2016

* You need more than this recommended capacity if you plan on adding many of the marketplace items from Azure.

Data disk drive configuration: All data drives must be of the same type (all SAS, all SATA, or all NVMe) and capacity. If SAS disk drives are used, the disk drives must be attached via a single path (no MPIO, multi-path support is provided).

HBA configuration options

  • (Preferred) Simple HBA
  • RAID HBA – Adapter must be configured in “pass-through” mode
  • RAID HBA – Disks should be configured as Single-Disk, RAID-0

Supported bus and media type combinations

  • RAID SSD (If the media type is unspecified/unknown*)
  • NVMe

* RAID controllers without pass-through capability can’t recognize the media type. Such controllers mark both HDD and SSD as Unspecified. In that case, the SSD is used as persistent storage instead of caching devices. Therefore, you can deploy the development kit on those SSDs.

To finally double check if all hardware requirements are met, you can run the pre-req script:

How to Install the Azure Stack Development Kit

Now let’s go on and install the ASDK on your server. You will find the download here:

The download may take some time as it is about +10 GB of size.

After the download has finished, you could extract it to the folder of your choice.

The CloudBuilder.VHDX provides the source for all Azure Stack services and is the basis for the installation. Place this VHDX in a destination folder of your choice and start the ASDK Installer script, which is available here:

The installer should look like the above and we then need to choose the button on the left to boot from the cloudbuilder.vhdx as a next step.

On this screen choose the folder where the vhdx file is sitting and point to a specific folder location to install dedicated drivers specific to your hardware. These will be integrated into the vhdx during the preparation phase.

Now we need to configure the administrator account and the password, which will be set identically for all accounts in Azure Stack. Finally, you have the choice of setting a computer name, a time zone, and the static IP configuration.

As Azure Stack ASDK is only supporting one NIC, you will have to choose the appropriate one, all others will be disabled by default.

When setting the Time Server IP, you will need to choose a proper time server as time issues are one of the most occurring errors during the installation. A misconfigured time server is the source for 80% of failed deployments. If you have no other one available, should help.

Now the system is mounting the VHDX file.

Finally, you just need to choose a server reboot option and it will boot into the VHDX. The first step of the deployment is done.

NOTE: If specific hardware drivers, in addition, are needed, install them after this reboot manually.

After the reboot, the original drive C: will be mounted as D:, so you will always have the chance to access these files (for missing drivers or anything else).

After having chosen the left button again, you will have the following deployment options:

  • Disconnected (and enabling ADFS only): if you choose this, there is no public Azure connectivity needed, but you will lose multi-tenancy.
  • Connected (connected to Azure, Azure China): this is probably the most used option, as it means that you would use Azure AD for Identity Management for Azure Stack itself (not the tenants, just all the administrative stuff)

Now let’s choose the corresponding AAD directly and set the local administrator password.

Let’s configure networking again.

Define the IP Info once again and optionally VLAN ID and DNS Forwarder

After having all steps done, the installation should start properly once you click Deploy.

After logging on with your Azure Credentials, the Script should run for approx. +4-5 hours, depending on the performance of your ASDK host.

When the deployment is finished, it will look like the above image.

If there are any issues that may have stopped the deployment, you can check the logfiles or just run the setup again using the /rerun parameter.

After having finished the second basic step, we will now need to configure Azure Stack to be fully functional.

To check if Azure Stack is working properly, you can check the following URLs:

Admin Portal: https://adminportal.local.azurestack.external

In the administrator portal, you can do things such as:

  • Manage the infrastructure (including system health, updates, capacity, etc.)
  • Populate the marketplace
  • Create subscriptions for users
  • Create plans and offers

Tenant Portal: https://portal.local.azurestack.external/

NOTE: You will need to use the account you configured during the deployment setup to login to these portals.


So, the installation took a while, didn’t it? Wonder why? Take a look at the following VMs. This is what you’ve just deployed to your ASDK host. Makes sense now doesn’t it?

From an architecture perspective, it’s important to keep in mind that this is a sandbox installation. Connecting outside services into the ASDK or any of the components inside of it will be virtually impossible. All traffic flows through BGPNAT-VM. Additionally, Azure Stack Hub will not be served with ongoing updates in this type of deployment in order to keep the latest updates you’ll need to reinstall each month.

There are now many other tasks that we now have to set up/configure (e.g. Registration with Azure, setting up accounts, plans, and offers, installing resource providers), which is something we will look at in the next chapter.

Microsoft Azure Stack Hub is an exciting solution in terms of hardware, software, integration with Azure, capabilities, features, management, and building modern applications. It features a holistic approach to coupling certified and supported hardware with the Azure stack of applications and infrastructure to allow companies to run native Azure workloads on-premises. However, companies may want to get their hands on Azure Stack Hub before purchasing to proof-of-concept the solution and also to setup Dev/Test environments for Azure Stack Hub. 

The Azure Stack Development Kit (ASDK) provides an automated way to provision a single-host Azure Stack host running all the required guest virtual machines. While the configuration is not supported for production use, it provides a great way to test out and experience Azure Stack Hub or provision Dev/Test environments. 

As shown in the walkthrough, the process to provision the single-node Azure Stack Development Kit environment is fairly straightforward. Once you download the required files, you configure the installation using the provided script. The PowerShell script will take the input from the configuration wizard and provision the environment accordingly.

To summarize, Azure Stack ASDK is a great way to start with Azure Stack Hub and will help you figure out if Azure Stack could fit into your existing environment. The next steps would then be going on with a physical multi-node PoC after having talked to your hardware vendor of choice.

What to learn more about the benefits of using Azure stack? Watch our free on-demand webinar Future-proofing your Datacenter with Microsoft Azure Stack

What about you? Have you had a chance to test Azure Stack Hub yet? What were your thoughts? Let us know in the comments section below if you have used the Azure Stack Development Kit (ASDK) to test out Azure Stack!

Altaro Hyper-V Backup
Share this post

Not a DOJO Member yet?

Join thousands of other IT pros and receive a weekly roundup email with the latest content & updates!

Frequently Asked Questions

The Azure Stack Development Kit (ASDK) is a single-node deployment of Azure Stack Hub, freely available for download that allows running all ASDK components on a single host with guest virtual machines. It allows easily spinning up an environment to evaluate Azure Stack Hub and develop modern apps on-premises (Dev/Test) environments. It is important to understand note that Azure Stack Development Kit (ASDK) is not supported for use in a production environment since it does not support key components of production infrastructure requirements such as high-availability. With the Azure Stack Hub infrastructure VMs running on a single server, the configuration is not intended for scalability, high-availability, or performance testing. However, again, its intended use case is for proof-of-concept environments and Dev/Test environments where this type of configuration would suffice.
A SKU in Microsoft Azure, similar to other cloud environments refers to a purchasable product or solution in the Microsoft Azure cloud environment. There may be several SKUs of a product, referring to different variations of product features, capabilities, and functionality
Azure Stack solutions refer to Azure services and capabilities in your environment of choice, including the enterprise datacenter, to edge locations and remote offices. With Azure Stack solutions, organizations can purchase a fully vetted solution, including hardware, networking, storage, and compute bundled together running Azure solutions and services on-premises. With the Azure Stack solution, businesses can run workloads on-premises and manage these with the same tools and management interfaces they are used to with workloads running in the Azure cloud.
There are multiple Azure SKUs across platforms, solutions, and services. The SKU refers to a specific offering in Azure a company wants to use.
Deploying the Azure Stack Development Kit is a process that allows easily spinning up a new ASDK environment using a download from Microsoft and PowerShell script to provision everything. You download the required installation files here: After downloading, extract the files and, using the CloudBuilder VHDX, start the ASDK installer script, found here: As shown in the walkthrough, you populate the required installation information and run the installer.

Leave a comment or ask a question

Your email address will not be published. Required fields are marked *

Your email address will not be published. Required fields are marked *

Notify me of follow-up replies via email

Yes, I would like to receive new blog posts by email

What is the color of grass?

Please note: If you’re not already a member on the Dojo Forums you will create a new account and receive an activation email.