{"title":"Configure Business Central Server","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/configure-server-instance/","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/administration/configure-server-instance, 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/administration/configure-server-instance","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":"Configure and modify settings in the Setup or Installed Business Central Server using PowerShell Cmdlets.","date":"2026-08-04","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Configure Business Central Server","slug":"configure-business-central-server","at":0,"chars":7175},{"level":2,"title":"Configure Business Central Server using Setup","slug":"configure-business-central-server-using-setup","at":1087,"chars":432},{"level":2,"title":"Configure Business Central Server after installation","slug":"configure-business-central-server-after-installation","at":1519,"chars":730},{"level":2,"title":" Configure server instance with Business Central Administration Shell","slug":"configure-server-instance-with-business-central-administration-shell","at":2249,"chars":1263},{"level":2,"title":"Restart Business Central Server after modifications","slug":"restart-business-central-server-after-modifications","at":3512,"chars":1631},{"level":3,"title":"Restart with the Services console","slug":"restart-with-the-services-console","at":4533,"chars":250},{"level":3,"title":"Restart using admin shell","slug":"restart-using-admin-shell","at":4783,"chars":360},{"level":2,"title":"Modify dynamically updatable settings","slug":"modify-dynamically-updatable-settings","at":5143,"chars":1558},{"level":2,"title":"Related information","slug":"related-information","at":6701,"chars":474}],"text":"# Configure Business Central Server\nAPPLIES TO: Business Central 2022 release wave 2 (version 21) and later. For earlier versions, refer to Configuring Business Central Server in outdated versions<configure-server-instance-archived>.\nWhen you run Business Central Setup and install Business Central Server, you provide information that is then used as the configuration for the default Business Central Server instance. This information is stored in a configuration file for the server instance called CustomSetting.config. The default location of the CustomSettings.config file is C:\\\\Program Files\\\\Microsoft Dynamics 365 Business Central\\\\NNN\\Service. Each Business Central Server instance has its own CustomSettings.config file.\nAfter you install Business Central Server, you can change any of the settings, including other settings that weren't available to you in Setup.\n> NOTE\n> For a complete reference of server instance settings, including descriptions, default values, and dynamic update information, go to Business Central Server instance settings<server-instance-settings>.\n## Configure Business Central Server using Setup\nTo install and configure the default Business Central Server instance, run Business Central Setup (setup.exe) and select one of these options:\n Demo Option\n Server Option\n Developer Option\n Customize > Server\nDepending on your selection, the Specify parameters page lets you configure several settings. See Installing Business Central using Setup<../deployment/install-using-setup>.\n## Configure Business Central Server after installation\nAfter you install Business Central Server, you can change the configuration settings in the CustomSettings.config file of a Business Central Server instance in the following ways:\n Using the Set-NAVServerConfiguration cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/set-navserverconfiguration> that's available in the Business Central Administration Shell.\n  See Using administration shell cmdlets to modify settings<#UsingPowerShell>.\n Editing CustomSettings.config using a text editor.\n  We recommend that you don't directly edit the configuration file, because if you make any errors in typing, the server instance might not start.\n##  Configure server instance with Business Central Administration Shell\nThe Business Central Administration Shell includes `Set-` cmdlets for creating and modifying Business Central Server instances. Use the Set-NAVServerConfiguration cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/set-navserverconfiguration> to change the settings listed in Business Central Server instance settings<server-instance-settings>. Specify the setting's Key Name in the `-KeyName` parameter and its new value in the `-KeyValue` parameter.\n1. Start Business Central Administration Shell for your current version as an administrator.\n See Run Business Central Administration Shell<administration-shell>.\n1. Run the following command:\n ```powershell\n Set-NAVServerConfiguration -ServerInstance \"<InstanceName>\" -KeyName \"<KeyName>\" -KeyValue \"<Value>\"\n ```\n Replace:\n  `<InstanceName>` with the server instance name.\n  `<KeyName>` with the setting's key name.\n  `<Value>` with the new value for the setting.\n For example, the following command changes the database used by the MyInstance server instance to `Database-B`:\n ```powershell\n Set-NAVServerConfiguration -ServerInstance \"MyInstance\" -KeyName \"DatabaseName\" -KeyValue \"Database-B\"\n ```\n## Restart Business Central Server after modifications\nThere are a could factors that determine whether you must restart the server instance after you make changes before they take effect.\n If you modify the CustomSettings.config file directly, you must restart the Business Central Server instance before any changes can take effect.\n If you use the Business Central Administration Shell, the Set-NAVServerConfiguration cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/set-navserverconfiguration> doesn't always require restarting the server instance.\n  It depends on the configuration setting that you change. There are several settings that are dynamically updatable. Dynamically updatable means that a server instance restart isn't necessarily required after modification. See Modifying dynamically updatable settings<#DynamicSettings>.\n  These settings are indicated by the text Dynamically updatable: Yes in Business Central Server instance settings<server-instance-settings>.\n### Restart with the Services console\n1. Search for and open Services (services.msc).\n1. Find Microsoft Dynamics 365 Business Central Server InstanceName], like Microsoft Dynamics 365 Business Central Server BC280.\n1. Right-click and select Restart.\n### Restart using admin shell\n1. Start Business Central Administration Shell for your current version as an administrator.\n See Run Business Central Administration Shell<administration-shell>.\n1. Run the following command:\n ```powershell\n Restart-NAVServerInstance -ServerInstance \"<InstanceName>\"\n ```\n Replace `<InstanceName>` with the server instance name.\n## Modify dynamically updatable settings\nFor dynamically updatable settings, use the `-ApplyTo` parameter to specify how to apply the change. The change can be written directly to the configuration file (CustomSettings.config) and applied to the current server instance state. The option you choose determines whether a server instance restart is required for the change to take effect. The parameter has three options, as described in the following table:\nOption|Description\nConfigFile|Saves the change to the configuration file of the server instance. The change doesn't take effect until the server instance is restarted.\nMemory|Applies the change only to the server instance's current state. The changes take effect immediately, without having to restart the server instance. The change is stored in memory. The next time the server instance is restarted, it reverts to the setting in the configuration file.\nAll|Applies the change to the server instance's current setting state (in memory) and to the configuration file. The changes take effect immediately, without having to restart the server instance.\nFor example, the following command sets the value for the MaxStreamReadSize key to `42424242`, without having to restart the server instance.\n```powershell\nSet-NAVServerConfiguration -ServerInstanceMyInstance -KeyName MaxStreamReadSize -KeyValue 42424242 -ApplyTo Memory\n```\nLearn more about running the Business Central Administration Shell in Business Central PowerShell cmdlets<https://learn.microsoft.com/powershell/business-central/overview>.\n## Related information\nConfiguring Business Central Web Server Instances<configure-web-server>\nBusiness Central Server Administration Tool<administration-tool>\nEnhancing Business Central Server Security<../security/enhancing-server-instance-security>\nBusiness Central Windows PowerShell Cmdlets<https://learn.microsoft.com/powershell/business-central/overview>\nConfiguring Help<../deployment/configure-help>\nHiding UI Elements<hide-ui-elements>\n../developer/devenv-debugging"}