Quickstart: Create your first container in Azure Container Instances

Azure Container Instances makes it easy to create and manage Docker containers in Azure, without having to provision virtual machines or adopt a higher-level service. In this quickstart, you use the Azure portal to create a container in Azure and expose it to the internet with a fully qualified domain name (FQDN). After configuring a few settings, you'll see this in your browser:

App deployed using Azure Container Instances viewed in browser

Sign in to Azure

Sign in to the Azure portal at https://portal.azure.com.

If you don't have an Azure subscription, create a free account before you begin.

Create a container instance

Select the Create a resource > Containers > Container Instances.

Begin creating a new container instance in the Azure portal

Enter the following values in the Container name, Container image, and Resource group text boxes. Leave the other values at their defaults, then select OK.

  • Container name: mycontainer
  • Container image: microsoft/aci-helloworld
  • Resource group: myResourceGroup

Configuring basic settings for a new container instance in the Azure portal

You can create both Windows and Linux containers in Azure Container Instances. For this quickstart, leave the default setting of Linux to deploy the Linux-based microsoft/aci-helloworld image.

Under Configuration, specify a DNS name label for your container. The name must be unique within the Azure region you create the container instance. Your container will be publicly reachable at <dns-name-label>.<region>.azurecontainer.io.

Leave the other settings in Configuration at their defaults, then select OK to validate the configuration.

Configuring a new container instance in the Azure portal

When the validation completes, you're shown a summary of the container's settings. Select OK to submit your container deployment request.

Settings summary for a new container instance in the Azure portal

When deployment starts, a tile appears on your portal dashboard indicating the deployment is in progress. Once deployed, the tile displays your new container instance.

Creation progress of a new container instance in the Azure portal

Select the mycontainer container instance to display its properties. Take note of the FQDN (the fully qualified domain name) of the container instance, as well its Status.

Container group overview in the Azure portal

Once its Status is Running, navigate to the container's FQDN in your browser.

App deployed using Azure Container Instances viewed in browser

Congratulations! By configuring just a few settings, you've deployed a publicly accessible application in Azure Container Instances.

View container logs

Viewing the logs for a container instance is helpful when troubleshooting issues with your container or the application it runs.

To view the container's logs, under SETTINGS, select Containers, then Logs. You should see the HTTP GET request generated when you viewed the application in your browser.

Container logs in the Azure portal

Clean up resources

When you're done with the container, select Overview for the mycontainer container instance, then select Delete.

Deleting the container instance in the Azure portal

Select Yes when the confirmation dialog appears.

Delete confirmation of a container instance in the Azure portal

Next steps

In this quickstart, you created an Azure container instance from an image in the public Docker Hub registry. If you'd like to build a container image yourself and deploy it to Azure Container Instances from a private Azure container registry, continue to the Azure Container Instances tutorial.