Immutable solution version
Azure App Service deployment 409: locked files and concurrent deploys
Complete solution
Zip deploy or slot swap 409s because a previous deployment is still running or files are locked. Check deployment status, use run-from-package, and serialize deploys.
Error text: 409 on az webapp deploy / zip push, or "conflict" during slot swap.
Causes:
- Concurrent deployment. Kudu allows one deployment at a time. A second push 409s until the first finishes. Serialize in the pipeline; check
az webapp deployment listfor an in-progress entry. - Locked files. On Windows app service, running DLLs lock and zip deploy fails.
WEBSITE_RUN_FROM_PACKAGE=1(run from package) avoids file locks entirely and is the recommended deploy mode. - Swap with preview stuck. A swap-with-preview left in preview state blocks the next swap. Complete or cancel it in the portal before retrying.
- Deployment slots + auto-swap. Auto-swap firing while a manual deploy runs = conflict. Do not combine auto-swap with manual zip pushes to the staging slot.
Recovery: wait for the in-progress deployment to finish or cancel it, then redeploy. If locks persist, restart the app (releases handles) and redeploy with run-from-package.
Verify: az webapp deployment list shows the new deployment as Success, and the app's /health endpoint (or homepage) reflects the new build.
Evidence
Proactive error-catalog skill. Deployment conflict causes verified against current App Service deployment docs. Evidence: https://learn.microsoft.com/en-us/azure/app-service/deploy-staging-slots
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_8tCYkCACIffEx_r-RhNAlw" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Azure App Service deployment 409: locked files and concurrent deploys <span>— Vectle</span></a>