Installation in Dynamics 365 Business Central On-Premise
For Microsoft Dynamics 365 Business Central On-Premise environments, so-called Runtime Packages are provided. These are precompiled extensions that you can directly install in your Microsoft Dynamics 365 Business Central environment.
Good to know
It is important to use the correct version for the platform version of Microsoft Dynamics 365 Business Central you are using. Runtime Packages are only compatible with the version they were compiled for.
Using them in a different version may lead to errors.
Requirements
As all 365 business development apps are provided as ISV modules in ISV object range, they require Microsoft Dynamics 365 Business Central license extension, to gain access to the ISV object range and the corresponding app functionality.
Good to know
Extending the Microsoft Dynamics 365 Business Central customer license with the 365 business development app license is only necessary for Microsoft Dynamics 365 Business Central On-Premise environments and does not require the customer to actually purchase the 365 business development app license.
The 365 business development app license is provided free of charge to all Microsoft Dynamics 365 Business Central customers, as long as they have a valid Microsoft Dynamics 365 Business Central customer license.
To execute 365 business development apps in Microsoft Dynamics 365 Business Central On-Premise environments, it's necessary to extend the Microsoft Dynamics 365 Business Central customer license (*.bclicense) with the corresponding 365 business development app license. Typically, this action is performed by your Microsoft Dynamics 365 Business Central partner through the Microsoft Partner Source Business Center (PSBC).
Info
To gain access to the 365 business development app license the Microsoft Dynamics 365 Business Central partner must have signed the 365 business development Partner Agreement.
If you are a Microsoft Dynamics 365 Business Central partner and have not yet signed the 365 business development Partner Agreement, please contact us at info@365businessdev.com to receive the agreement. After signing, you will gain access as authorized reseller to the 365 business development app license and can extend your customers' licenses accordingly.
ISV Module
All 365 business development apps are provided as ISV modules. The following table lists the ISV provider, module ID, ID, and name of the 365 business development apps, which you can use to extend the Microsoft Dynamics 365 Business Central customer license (*.bclicense):
| ISV Provider | Module ID | ID | Name |
|---|---|---|---|
| 7058648 | 78954 | 5523650 | 365 business development Apps |
Good to know
Since early 2025 the 365 business development apps are no longer splitted into individual ISV modules for licensing. Instead, all 365 business development apps are now provided as a single ISV module with the ID 5523650. This simplifies the licensing process and allows you to use all 365 business development apps without needing to license them individually.
Installation
The installation of extensions in Microsoft Dynamics 365 Business Central On-Premise environments is done via Windows PowerShell. To simplify the installation and reduce the potential for errors, we provide a PowerShell script, the 365 business development App Installer, which you can use to install our extensions for Microsoft Dynamics 365 Business Central.
Download
The 365 business development App Installer is available on our GitHub page. There you can find the source code of the PowerShell script and download it. The 365 business development App Installer is licensed under the MIT license. This means you can use the script for your own purposes as long as you comply with the license terms.
365 business development App InstallerUsage
This section explains how to use the 365 business development App Installer to install our extensions in Microsoft Dynamics 365 Business Central On-Premise environments.
Info
Please note that the 365 business development App Installer must be run in a PowerShell session with elevated privileges (Administrator).
The execution must take place on the Microsoft Dynamics 365 Business Central server, as the Microsoft Dynamics 365 Business Central PowerShell modules are required for the installation.
- Download the 365 business development App Installer.
- Start Microsoft PowerShell or Microsoft Dynamics 365 Administration Shell as Administrator.
- Navigate to the download location (e.g.,
C:\Run). - Run the
Install-Apps.ps1PowerShell script.Code - Select the Microsoft Dynamics 365 Business Central service instance (only if more than one instance is installed).
Info
You can find the Application ID and the full command for the 365 business development App Installer on the respective product's download page.
Go to the 365 business development Downloads.
Possible Issues
PowerShell Execution Policy
Depending on your setup, you may need to allow the execution of the PowerShell script Install-Apps.ps1. Use the Set-ExecutionPolicy CmdLet to allow execution. For more information, visit the documentation.
Code
How It Works
The 365 business development App Installer essentially performs the following steps:
- Identifies the Microsoft Dynamics 365 Business Central service instances installed on the current computer.
- Selects the Microsoft Dynamics 365 Business Central service instance for installation (only if more than one instance is found).
- Identifies the platform version.
- Downloads the correct version of the extensions/apps to be installed.
- Installs the extensions/apps.
- Synchronizes the schema of the extensions/apps.
- Updates the extensions/apps (if an earlier version was already installed).
- Uninstalls the old version of the extensions/apps (if an earlier version was already installed).
Example
Code