Deploying and installing

Path: Development > Extension lifecycle > Deploying and installing · tier official · system development · narrative reviewed (checked by Opus)

Overview

This section covers the operational lifecycle of an extension after it is built. It explains how to publish a package to a server, sync it with the tenant database, and install it, and how to write install codeunits that run on install or reinstall.

Further pages cover removal and updates. One explains the three levels of removing an extension: uninstall, unpublish and clean-mode schema removal. Others cover manually upgrading Marketplace apps in production and the partner duties for keeping apps compatible with major and minor releases.

A FAQ addresses managing and submitting Marketplace offers through Partner Center. Start with Publishing and Installing an Extension for the basic flow, then move to install code, upgrades and maintenance as needed.

Key points

• Publishing and installing uses the publish-navapp, sync-navapp and install-navapp cmdlets, or the extension management page.
• Install code uses codeunits with OnInstallAppPerCompany and OnInstallAppPerDatabase triggers, with handling for fresh installs and reinstalls.
• Uninstall disables an extension on tenants, unpublish removes it from the server instance, and clean-mode synchronization deletes the database schema.
• Marketplace apps in production can be upgraded manually to the latest version from the Extension Management page or the Admin Center.
• Partners must keep apps updated with major and minor releases, including preview period testing and update and grace periods.
• Enforced update periods and incompatibility notifications apply, and apps can be removed automatically if not updated.
• The Marketplace offer FAQ covers the Partner Center submission process, Go Live, review and publish, and technical validation.

Learn pages

• FAQ about managing and submitting your Business Central offer: Get answers to some of your questions about managing an offer in Partner Center when you build an app for Dynamics 365 Business Central
• How to Unpublish and Uninstall an Extension: Description of the process of upublishing and uninstalling an extension
• Maintain Marketplace apps and per-tenant extensions: Learn about resources available to you as the publisher of an app or per-tenant extension for keeping your code in compliance with the base product.
• Publishing and Installing an Extension: Description of the process of publishing and installing an extension.
• Upgrading Marketplace Apps in Production: Describes how to upgrade apps available on Marketplace that are already in running in production.
• Writing extensions installation code: Describes how to add code to run to initialize data when an extension is installed.

Videos, posts and code changes

Linked by a Haiku matcher with a grounding quote from the item’s summary (link/topics.ts); machine-generated.

• #2376 fix: modified files with umlauts (code change): “Incremental build detection now finds project and app paths that contain umlauts”
• #11065 Open installation status after AppSource install failure (code change): “Failed AppSource installations now display a prompt to open installation status”
• Mastering Business Central API for App Management (community post): “deploying .app files, monitoring installation progress, handling failures, and uninstalling extensions”
• Managing Apps in the Business Central Admin Center (community post): “Installing a PTE means choosing a deployment schedule and a sync mode”
• What’s New: AL-Go for GitHub on Delivery and Deployment (2025 release wave 1) (video): “Dependency Install Mode; Test Apps Deployment; Pull Request Artifact Deployment”

Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.