Docker for Azure Frequently asked questions (FAQ)

Estimated reading time: 3 minutes

Stable and beta channels

Two different download channels are available for Docker for AWS:

  • The stable channel provides a general availability release-ready deployment for a fully baked and tested, more reliable cluster. The stable version of Docker for AWS comes with the latest released version of Docker Engine. The release schedule is synched with Docker Engine releases and hotfixes. On the stable channel, you can select whether to send usage statistics and other data.

  • The beta channel provides a deployment with new features we are working on, but is not necessarily fully tested. It comes with the experimental version of Docker Engine. Bugs, crashes and issues are more likely to occur with the beta cluster, but you get a chance to preview new functionality, experiment, and provide feedback as the deployment evolve. Releases are typically more frequent than for stable, often one or more per month. Usage statistics and crash reports are sent by default. You do not have the option to disable this on the beta channel.

Can I use my own VHD?

No, at this time we only support the default Docker for Azure VHD.

Can I specify the type of Storage Account I use for my VM instances?

Not at this time, but it is on our roadmap for future releases.

Which Azure regions will Docker for Azure work with?

Docker for Azure should work with all supported Azure Marketplace regions.

Where are my container logs?

All container logs are aggregated within the xxxxlog storage account.

Where do I report problems or bugs?

Send an email to or post to the Docker for Azure GitHub repositories.

In Azure, if your resource group is misbehaving, please run the following diagnostic tool from one of the managers - this will collect your docker logs and send them to Docker:

$ docker-diagnose
OK hostname=manager1
OK hostname=worker1
OK hostname=worker2
Done requesting diagnostics.
Your diagnostics session ID is 1234567890-xxxxxxxxxxxxxx
Please provide this session ID to the maintainer debugging your issue.

Note: Your output will be slightly different from the above, depending on your swarm configuration.


Docker for Azure sends anonymized minimal metrics to Docker (heartbeat). These metrics are used to monitor adoption and are critical to improve Docker for Azure.

How do I run administrative commands?

By default when you SSH into a manager, you will be logged in as the regular username: docker - It is possible however to run commands with elevated privileges by using sudo. For example to ping one of the nodes, after finding its IP via the Azure/Azure portal (e.g., you could run:

$ sudo ping

Note: Access to Docker for Azure and Azure happens through a shell container that itself runs on Docker.

What are the different Azure Regions?

All regions can be found here: Microsoft Azure Regions An exerpt of the above regions to use when you create your service principal are:

chat icon Feedback? Suggestions? Can't find something in the docs?
Edit this page Request docs changes Get support
Rate this page: