Business Central 2025 release wave 2 (v27)
Upgrade guidance for on-premises Business Central 2025 release wave 2 (version 27). It answers questions about upgrade paths, pre-upgrade considerations, installing a version 27 update, and upgrading the System and Base Application from versions 25 and 26.
Path: Business Central on-premises > Upgrade > Business Central 2025 release wave 2 (v27) · tier official · system platform · narrative reviewed (checked by Opus)
Overview
This section covers moving an on-premises Business Central deployment to 2025 release wave 2 (version 27). It has four pages: an overview of upgrade paths, a page of considerations before upgrading, a procedure for installing a version 27 update, and a step-by-step procedure for upgrading the Microsoft System and Base Application.
Start with the overview page on upgrade paths. It covers deprecated features and the system application refactoring. Then read the considerations page, which lists items to check before you begin. Finally, follow either the update installation page or the System and Base Application upgrade page, depending on your scenario.
The technical steps are similar in both procedures: database conversion, extension publishing, tenant synchronization, and data upgrade. The upgrade page also covers permission set migration and encryption management.
Key points
- The overview page covers upgrade paths to version 27, deprecated features, system application refactoring, the base application, and add-on extensions.
- The pre-upgrade considerations page covers versions 26 to 29. It addresses deprecated or redesigned functionality, deleted objects (v24 and earlier), and the performance impact of installed extensions.
- Schema changes in the Subscription Billing extension (v25 to v26 and later) are covered, including force sync for schema migration.
- Deployment changes from v23 are noted: server port 7085 and SPN delegation configuration.
- Microsoft recommends transitioning to AL-based permissions.
- The update installation page covers database conversion, extension publishing, tenant synchronization, platform upgrade, and data upgrade, including multitenant deployments.
- The System and Base Application upgrade page gives steps for upgrading from versions 25 and 26 to version 27. It includes permission set migration and encryption management.
Learn pages
- Considerations before upgrading to Business Central version 26 and later: This article provides tips and considerations to prepare a solution when you’re planning to upgrade to Business Central 2025 release wave 1 and later.
- Install a Business Central 2025 release Wave 2 (version 27) Update: This article describes the tasks required for getting the monthly version 27 update applied to your Dynamics 365 Business Central on-premises.
- Upgrading Microsoft System and Base Application to Version 27: Describes how to upgrade an unmodified Business Central version 15 through 25 to version 27
- Upgrading to Dynamics 365 Business Central 2025 release wave 2: Provides an overview of Business Central 2025 release wave 2 upgrade process.
Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.
What Learn documents here 4 Learn pages
- learnConsiderations before upgrading to Business Central version 26 and later2026-08-31
- learnInstall a Business Central 2025 release Wave 2 (version 27) Update2026-02-02
- learnUpgrading Microsoft System and Base Application to Version 272026-01-08
- learnUpgrading to Dynamics 365 Business Central 2025 release wave 22026-01-06