{"title":"Business Central Single-Tenant Full Upgrade Quick Reference","url":"https://jonas-paprotka.de/docs/dev-itpro/upgrade/singletenant-upgrade-checklist/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/singletenant-upgrade-checklist, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/singletenant-upgrade-checklist","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Get an overview of the steps required to upgrade from one version of Business Central on-premises to the next.","date":"2024-04-18","meta":{"topic":"upgrade-and-migration-article"},"outline":[{"level":1,"title":"Business Central Single-Tenant Full Upgrade Quick Reference","slug":"business-central-single-tenant-full-upgrade-quick-reference","at":0,"chars":3635},{"level":2,"title":"Prerequisite tasks on old database","slug":"prerequisite-tasks-on-old-database","at":265,"chars":724},{"level":2,"title":"Prepare the old database for data upgrade","slug":"prepare-the-old-database-for-data-upgrade","at":989,"chars":643},{"level":2,"title":"Run the data upgrade","slug":"run-the-data-upgrade","at":1632,"chars":1165},{"level":2,"title":"Publish, upgrade, and install extensions","slug":"publish-upgrade-and-install-extensions","at":2797,"chars":522},{"level":2,"title":"Post-upgrade tasks","slug":"post-upgrade-tasks","at":3319,"chars":316}],"text":"# Business Central Single-Tenant Full Upgrade Quick Reference\nThis article provides an overview of the full upgrade process for Business Central in a single-tenant deployment. For more detailed steps, see Upgrading the Data: Single-Tenant Mode<upgrading-the-data>.\n## Prerequisite tasks on old database\n|Step|More info|Done|\n|----|-----------|--|\n|Upgrade application code.|See...<transition-from-codeunit1>||\n|Convert custom V1 extensions to V2 extensions.|See...<../developer/devenv-upgrade-v1-to-v2-overview>||\n|Export permissions and permission sets.<br />Important: Make sure your computer uses the same codepage as the data.|See...<how-to--import-export-permission-sets-permissions>||\n|Export encryption keys from the old deployment.|See...<how-to-export-and-import-encryption-keys>||\n|Prepare for transitioning from codeunit 1.<br />Note: Dynamics NAV upgrade only|See...<transition-from-codeunit1>|\n|Install Business Central components.|See...<../deployment/install-using-setup>||\n## Prepare the old database for data upgrade\n|Step|More info|Done|\n|----|-----------|--|\n|Backup the database.|See...<https://learn.microsoft.com/sql/relational-databases/backup-restore/create-a-full-database-backup-sql-server>||\n|Uninstall all extensions.|See...<../developer/devenv-unpublish-and-uninstall-extension-v2>|\n|Upload a Business Central partner license.|See...<../cside/cside-upload-license-file>||\n|Delete all objects except tables.<br /> Important Do not synchronize schema at this point.|See...<upgrading-the-data#DeleteObjects>||\n|Clear server instance and debugger breakpoint tables.|See...<upgrading-the-data#ClearServer>||\n## Run the data upgrade\n|Step|More info|Done|\n|----|-----------|--|\n|Open Dynamics NAV Development Environment for Business Central as an administrator||\n|Connect to and convert the database.|See...<../cside/cside-open-database>|\n|Import upgraded application and upgrade toolkit objects (.fob files).<br />Important: Select to synchronize later.|See...<../cside/cside-import-objects>||\n|Connect a Business Central Server instance to the converted database.|See...<../administration/connect-server-to-database>||\n|Compile all objects.<br />Important: Choose to synchronize schema later.|See...<../cside/cside-compiling-objects>||\n|Increase the application version of the database,<br />Note: Dynamics NAV 2018 upgrade only|See...<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/set-navapplication>|\n|Synchronize the database.|See...<../administration/synchronize-tenant-database-and-application-database>||\n|Run the data upgrade.|See...<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/start-navdataupgrade>||\n|Update Javascipt control add-ins the data upgrade.|See...<converting-a-database#JSaddins>||\n## Publish, upgrade, and install extensions\n|Step|More info|Done|\n|----|-----------|--|\n|Publish system and test symbols, generate application symbols.|See...<upgrading-the-data#AddExtensions>|\n|Publish, synchronize, and upgrade to new versions of Microsoft extensions from installation media.|''||\n|Repair, synchronize, and install old extension versions that were not upgraded in previous step.|''||\n|Run the data upgrade on the new extension versions.|''||\n|Repair other custom extensions to work on new platform.|''||\n## Post-upgrade tasks\n|Step|More info|Done|\n|----|-----------|--|\n|Import permissions and permission sets.|See...<how-to--import-export-permission-sets-permissions>||\n|Import encryption keys|See...<how-to-export-and-import-encryption-keys>||\n|Upload the customer license.|See...<../cside/cside-upload-license-file>||"}