| title | Quickstart: Deploy Your First Container App Using the Azure Portal |
|---|---|
| description | Find out how to use the Azure portal to deploy your first application to Azure Container Apps and verify the deployment. |
| services | container-apps |
| author | craigshoemaker |
| ms.service | azure-container-apps |
| ms.topic | quickstart |
| ms.date | 11/12/2025 |
| ms.author | cshoe |
| ms.custom | mode-ui |
In this quickstart, you use the Azure portal to create an Azure Container Apps environment and deploy your first container app.
Container Apps provides a way to run microservices and containerized applications on a serverless platform. With Container Apps, you can enjoy the benefits of running containers while leaving behind the concerns of manually configuring cloud infrastructure and complex container orchestrators.
-
An Azure account with an active subscription. If you don't already have one, you can create an account for free.
-
The
Microsoft.Appresource provider registered in your Azure subscription.
Begin by signing in to the Azure portal.
To create your container app, start at the Azure portal home page.
-
In the top search bar, search for Container Apps.
-
In the search results, select Container Apps.
-
Select Create > Container App.
On the Basics tab, take the following steps:
-
Under Project details, take the actions listed in the table:
Setting Action Subscription Select your Azure subscription. Resource group Select Create new and enter my-container-apps. Container app name Enter my-container-app. Optimize for Azure Functions Leave the checkbox unselected. Select it only if you want to create a function app. Deployment source Select Container image. -
Under Container Apps environment, take the actions listed in the table:
Setting Action Region Select a region near you. Container Apps environment Use the default value.
-
Select Next: Container.
-
Select Use quickstart image.
[!INCLUDE container-apps-create-portal-deploy.md]
-
The following page appears in your browser.
:::image type="content" source="media/get-started/azure-container-apps-quickstart.png" alt-text="Screenshot of a browser page, with a message about the container app running with a Hello World image, plus other information about container apps.":::
If you're not going to continue to use this application, you can delete the container app and all the associated services by removing the resource group.
-
In the Azure portal, go to the Overview page for your container app. Under Essentials, select the my-container-apps resource group.
-
On the resource group Overview page, select Delete resource group.
-
In the Delete a resource group dialog, enter the resource group name, my-container-apps.
-
Select Delete, and then confirm your selection.
The process to delete the resource group can take a few minutes to finish.
Tip
Having issues? Let us know on GitHub by opening an issue in the Azure Container Apps repo.
[!div class="nextstepaction"] Communication between microservices