Upgrade to App Service Environment v3
Important
If you're currently using App Service Environment v1 or v2, you must migrate your workloads to App Service Environment v3. App Service Environment v1 and v2 will be retired on 31 August 2024. Failure to migrate by that date will result in loss of the environments, running applications, and all application data.
As of 29 January 2024, you can no longer create new App Service Environment v1 and v2 resources using any of the available methods including ARM/Bicep templates, Azure Portal, Azure CLI, or REST API.
This page is your one-stop shop for guidance and resources to help you upgrade successfully with minimal downtime. Follow the guidance to plan and complete your upgrade as soon as possible. This page is updated with the latest information as it becomes available.
Upgrade steps
| Step | Action | Resources |
|---|---|---|
| 1 | Pre-flight check | Determine if your environment meets the prerequisites to automate your upgrade using the migration feature. - Automated upgrade using the migration feature If not, you can upgrade manually. - Manual migration |
| 2 | Migrate | Based on results of your review, either upgrade using the migration feature or follow the manual steps. - Use the automated migration feature - Migrate manually |
| 3 | Testing and troubleshooting | Upgrading using the automated migration feature requires a 3-6 hour service window. Support teams are monitoring upgrades to ensure success. If you have a support plan and you need technical help, create a support request. |
| 4 | Optimize your App Service plans | Once your upgrade is complete, you can optimize the App Service plans for additional benefits. Review the autoselected Isolated v2 SKU sizes and scale up or scale down your App Service plans as needed. - Scale down your App Service plans - App Service Environment post-migration scaling guidance Explore reserved instance pricing, savings plans, and check out the pricing estimates if needed. - App Service pricing page - How reservation discounts apply to Isolated v2 instances - Azure pricing calculator |
| 5 | Learn more | Frequently asked questions Community support |
Additional information
What are the benefits of upgrading?
App Service Environment v3 is the latest version of App Service Environment. It's easier to use, runs on more powerful infrastructure that can go up to 64 cores and 256-GB RAM with faster scaling speeds for both Windows and Linux, and has simpler network topology. For more information about these and other benefits, see the following resources.
- Three reasons why you should prioritize migrating to App Service Environment v3 for your business
- Estimate your cost savings by migrating to App Service Environment v3
- Using App Service Environment v3 in Compliance-Oriented Industries
What changes when upgrading to App Service Environment v3?
What tooling is available to help with the upgrade to App Service Environment v3?
- In-place migration feature migrates your App Service Environment to App Service Environment v3 in-place. In-place means that your App Service Environment v3 replaces your existing App Service Environment in the same subnet. There's application downtime during the migration because a subnet can only have a single App Service Environment at a given time. For more information about this feature, see Automated upgrade using the in-place migration feature.
- Manual migration options are available if you can't use the automated migration features. For more information about these options, see Migration alternatives.
Migration path decision tree
Use the following decision tree to determine which migration path is right for you.
Cost saving opportunities after upgrading to App Service Environment v3
The App Service plan SKUs available for App Service Environment v3 run on the Isolated v2 (Iv2) tier. The number of cores and amount of RAM are effectively doubled per corresponding tier compared the Isolated tier. When you migrate, your App Service plans are converted to the corresponding tier. For example, your I2 instances are converted to I2v2. While I2 has two cores and 7-GB RAM, I2v2 has four cores and 16-GB RAM. If you expect your capacity requirements to stay the same, you're over-provisioned and paying for compute and memory you're not using. For this scenario, you can scale down your I2v2 instance to I1v2 and end up with a similar number of cores and RAM that you had previously.
Note
For the most up-to-date estimates, see the Azure pricing calculator.
Break even point
In most cases, migrating to App Service Environment v3 allows for cost saving opportunities. However, cost savings might not always be possible, especially if you're required to maintain a large number of small instances.
Your App Service Environment v3 is now more expensive than your App Service Environment v2. As you start add more I1 instances, and therefore need more I1v2 instances when you migrate, the difference in price becomes more significant. If this scenario is a requirement for your environment, you might need to plan for an increase in your monthly cost. The following graph visually depicts the point where App Service Environment v3 becomes more expensive than App Service Environment v2 for this specific scenario.
Note
For an estimate that reflects your situation, see the Azure pricing calculator.
For more scenarios on cost changes and savings opportunities with App Service Environment v3, see Estimate your cost savings by migrating to App Service Environment v3.
We want your feedback!
Got 2 minutes? We'd love to hear about your upgrade experience in this quick, anonymous poll. You'll help us learn and improve.