Others

How to Remove a Business Central Extension from a Cloud Production Environment

Ayan MasoodAyan Masood Nov 3, 2026 869 views

Question details

The user needs to remove or update an AL extension published to a Dynamics 365 Business Central cloud environment because local Docker commands are incompatible.

How to Remove a Business Central Extension from a Cloud Production Environment
Product
Microsoft Dynamics 365 Business Central
Device & OS
not provided
Scenario
Managing AL extensions in a cloud production environment where local BcContainerHelper commands fail due to a lack of cloud authentication context.
Observed behavior
The extension cannot be updated locally via Docker commands, requiring standard cloud-based uninstallation procedures to clear the conflict.
Before you start

Ensure you have full Administrator permissions in the Dynamics 365 Business Central web client and Admin Center before attempting to uninstall or manage tenant extensions.

Solution 1Recommended

Uninstall the Extension via the Business Central Web Client

Use the built-in Extension Management interface within your Business Central tenant to safely uninstall extensions from the cloud environment.

Since local Docker-based deployment tools (like BcContainerHelper) cannot authenticate against a live cloud production environment, all extension removals must be handled through the official administration UI or appropriate cloud-based PowerShell modules.

1
Access your cloud environment

Log in to your Microsoft Dynamics 365 Business Central cloud production environment with administrator credentials.

2
Open Extension Management

Click the 'Tell Me' (search magnifying glass) icon in the top right corner, type 'Extension Management', and select the matching link.

3
Locate the target extension

Scroll through the list or use the search function to find the specific AL extension you need to remove.

4
Uninstall the extension

Select the extension, click on the 'Uninstall' action from the top menu, and follow the confirmation prompts to remove it from your environment.

Uninstall the Extension via the Business Central Web Client
Next Steps: Once uninstalled, you can deploy your updated extension version via the standard Extension Management upload feature or through your CI/CD pipeline.
Free Microsoft Office alternative

Boost Your Everyday Productivity with WPS Office

While resolving backend ERP configurations requires specialized Dynamics 365 admin tools, for your everyday documentation, spreadsheet, and presentation needs, WPS Office offers a powerful, intuitive, and highly compatible alternative to Microsoft Office.

  1. 1. Download the installer: Visit the official WPS Office website and click the free download button for your operating system.
  2. 2. Install the suite: Run the lightweight installer and follow the quick setup instructions.
  3. 3. Open your documents: Launch WPS Office to instantly open, edit, and save your existing Microsoft Office files seamlessly.
Fully compatible with Microsoft Word, Excel, and PowerPoint formats (.docx, .xlsx, .pptx).Lightweight installation that runs smoothly without heavily taxing your system resources.Free to use with a familiar, easy-to-navigate tabbed interface.Built-in PDF editing, conversion, and collaboration tools to streamline your daily workflow.
microsoft office alternative - wps office

Frequently Asked Questions

Why do BcContainerHelper commands fail for a Business Central cloud production environment?

BcContainerHelper and similar local Docker deployment commands are designed for local development or sandbox environments. They lack the authentication context required to execute directly against a secure cloud production tenant.

Can I completely unpublish an extension using the web client?

Administrators can easily 'uninstall' an extension from a specific tenant via the web client UI. However, 'unpublishing' an app globally often requires specialized deployment pipelines or access to the Business Central Admin Center.

What should I do if an extension blocks my Business Central environment upgrade?

You must access the Extension Management page to uninstall the conflicting or outdated extension, allow the environment upgrade to complete, and then publish a compatible, updated version of the extension.

Where can I find official support for Dynamics 365 Business Central extensions?

For specialized administrative or AL development support, you should consult the official Microsoft Dynamics 365 Business Central Community forums or reach out to a certified Business Central partner.