{"title":"Production and sandbox environments","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/environment-types/","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/environment-types, 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/environment-types","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":"Learn about the differences between production and sandbox environments for Dynamics 365 Business Central.","date":"2024-11-12","meta":{"topic":"article"},"outline":[{"level":1,"title":"Production and sandbox environments","slug":"production-and-sandbox-environments","at":0,"chars":19234},{"level":2,"title":"Production environments","slug":"production-environments","at":390,"chars":2284},{"level":3,"title":"Manage production environments","slug":"manage-production-environments","at":2427,"chars":247},{"level":2,"title":"Sandbox environments","slug":"sandbox-environments","at":2674,"chars":16071},{"level":4,"title":"Sandbox environment resource configuration","slug":"sandbox-environment-resource-configuration","at":4348,"chars":2706},{"level":3,"title":"Partner sandboxes","slug":"partner-sandboxes","at":7054,"chars":3396},{"level":3,"title":"Precautions for sandbox environments with production data","slug":"precautions-for-sandbox-environments-with-production-data","at":10450,"chars":4973},{"level":3,"title":"Manage sandbox environments","slug":"manage-sandbox-environments","at":15423,"chars":250},{"level":3,"title":"Presales performance evaluation","slug":"presales-performance-evaluation","at":15673,"chars":1877},{"level":3,"title":"Advanced user experience","slug":"advanced-user-experience","at":17550,"chars":453},{"level":3,"title":"Complete sample data","slug":"complete-sample-data","at":18003,"chars":742},{"level":2,"title":"Related information","slug":"related-information","at":18745,"chars":489}],"text":"# Production and sandbox environments\nYou can create environments of different types. Which type of environment to choose depends on what you need it for.\n> TIP\n> If you're new to environments, get an overview of how Microsoft Entra ID, environments, and companies work in Business Central online at Understanding the infrastructure of Business Central online<tenant-environment-topology>.\n## Production environments\nProduction environments are meant to be precisely that: Environments that a business can run their daily business in Business Central in, deployed on performance tiers in Azure with a guaranteed high level of availability and support.\nProduction environments are backed up automatically and frequently to help protect business data. See https://learn.microsoft.com/dynamics365/business-central/dev-itpro/faq#how-often-are-production-databases-backed-up.\nYou can create additional production environments for training or performance testing, for example. However, for training purposes, in many cases organizations will prefer to create a sandbox environment with production data. You can also create additional production environments to support offices in different countries/regions.\n> NOTE\n> The Premium and Essential subscription types give each Business Central customer one production environment and three sandbox environments at no extra charge. If the customer needs more production environments, they can buy more through their CSP partner. Each extra production environment includes three extra sandbox environments and 4 GB extra tenant-wide database capacity.\nAdministrators can create the additional environments in the Business Central administration center. The environments can be created for any country or region where Business Central is available<../compliance/apptest-countries-and-translations>, on any available version. The environments quota is applied when you try to create a new environment, or copy or restore an existing environment.\n> NOTE\n> A production environment can have a state of suspended if the subscription has been suspended, or if the environment has not been accessed for a long time. In those cases, you can only publish extensions to such an environment if it only has evaluation companies. If the suspended environment has been used for actual production so that it contains companies that are not evaluation companies, then you cannot publish extensions to it.\n### Manage production environments\nUse the Business Central administration center to manage the environments manually. See Managing Production and Sandbox Environments<tenant-admin-center-environments>.\nInstead, use the administration-center-api.\n## Sandbox environments\nSandbox environments are meant to be precisely that: Environments that you can play around with, use as a testbed for development, and delete at will. You can deploy apps straight from Visual Studio Code to a sandbox environment, and you can attach a debugging session to a sandbox.\nYou can also safely use sandboxes for training, such as for following a learning path from Microsoft Learn<https://learn.microsoft.com/learn/dynamics365/business-central>, because it's a safe environment to experiment with. If anything goes wrong, you just delete the sandbox and start over.\nSandbox environments can be created on or updated to preview versions during preview periods to preview and test upcoming functionality ahead of its official availability. See preview-environments.\nSandbox environments are handy for certain types of development scenarios because the debugging endpoint is open by default. This means that you can attach Visual Studio Code to a running system and debug through running code. It also allows you to publish directly to the environment from Code.\n> IMPORTANT\n> Outbound HTTP calls from apps/extensions are blocked by default and must be approved for each extension, otherwise instead of an external call, the system will display the following error message: The request was blocked by the runtime to prevent accidental use of production services.\n> To enable outbound HTTP calls, go to the Extension Management page in Business Central, and choose Configure. Then, on the Extension Settings page, make sure that Allow HttpClient Requests is selected. This setting must be enabled for each app/extension, including library apps.\n#### Sandbox environment resource configuration\n[This article is prerelease documentation and is subject to change.]\n> IMPORTANT\n > This is a production-ready preview feature.\n > Production-ready previews are subject to supplemental terms of use<https://go.microsoft.com/fwlink/?linkid=2189520>.\nEnvironment databases for sandbox environments are provisioned with different configurations than those for typical production environments. For some scenarios typically executed on sandbox environments, such as using the Performance Toolkit Extension<../developer/devenv-performance-toolkit> or testing Cloud Migration data upgrades, administrators may need a production-like configuration for their sandbox environment.\nAdministrators can temporarily match the database configuration of their sandbox environment to that of a typical production environment:\n1. Navigate to the Business Central administration center and select the sandbox environment.\n1. Select Match production configuration in the action ribbon.\n1. Select Save in the pane that opened. The sandbox environment's database configuration is matched to that of a typical production environment immediately.\n1. The sandbox environment's database configuration remains matched to that of a typical production environment for 72 hours, and automatically moves back to its prior configuration during the environment's first update window after the 72 hour period ends.\n> IMPORTANT\n> Changing the environment's configuration restarts the environment; ensure no users are active when you start this operation to avoid interrupting their work.\nThis operation is limited to three 72-hour configuration matches per tenant per calendar month; this allocation renews automatically once a new calendar month starts. It's not possible to match the environment for a period shorter or longer than 72 hours, and it's not possible to run this more than thrice per calendar month.\n> NOTE\n> The Premium and Essential subscription types give each Business Central customer one production environment and three sandbox environments at no extra charge. If the customer needs more production environments, they can buy more through their CSP partner. Each extra production environment includes three extra sandbox environments and 4 GB extra tenant-wide database capacity.\nAdministrators can create the additional environments in the Business Central administration center. The environments can be created for any country or region where Business Central is available<../compliance/apptest-countries-and-translations>, on any available version. The environments quota is applied when you try to create a new environment, or copy or restore an existing environment.\n### Partner sandboxes\nAs a partner, you can buy the Dynamics 365 Business Central Partner Sandbox license. You need a valid Microsoft Partner Network (MPN) ID. This offer was made available to support partners that need nonproduction environments to learn, test, develop, and deliver end-to-end customer demos with their solutions. The Partner Sandbox license has to be purchased for at least five users per tenant, gives access to Business Central Premium functionality, and acts as a normal Premium license that your customers might acquire.\n> IMPORTANT\n> The environments that you acquire through the Dynamics 365 Business Central Partner Sandbox license are strictly meant for use by partners for nonproduction scenarios (learning, demoing, development, and similar). You aren't allowed to use this license for customers (in a customer tenant), nor for production use (running business).\nWhile it's possible to sign up your own partner tenant for Dynamics 365 Business Central Partner Sandbox licenses, since this tenant is going to be used for nonproduction scenarios, for security reasons and easier administration we recommend you create a separate new Microsoft Entra tenant (for example, [your tenant].onmicrosoft.com) and sign it up for those licenses.\nThe first pack of five Partner Sandbox licenses grants a base environment quota<tenant-admin-center-capacity> of one production and three sandbox environments on the tenant. For each extra five Partner Sandbox licenses available on your tenant, the environments quota increases by three sandbox environments. Each Partner Sandbox license grants 5 GB of storage capacity on top of the 80-GB base storage quota<tenant-admin-center-capacity> to ensure sufficient storage remains available as the number of sandbox environments on the tenant increases. For example:\nNo. of Partner Sandbox licenses|Environments|Storage (Base + Per license)\n5 licenses|1 Production + 3 Sandbox|80 GB + 25 GB (5 × 5 GB) = 105 GB\n10 licenses|1 Production + 6 Sandbox|80 GB + 50 GB (10 × 5 GB) = 130 GB\n15 licenses|1 Production + 9 Sandbox|80 GB + 75 GB (15 × 5 GB) = 155 GB\nThis pattern continues for each additional five Partner Sandbox licenses.\nTenants that have the Partner Sandbox license can create sandbox environments on Early Access Preview versions. See preview-environments#early-access-preview.\nPartner Sandbox licenses can but don't have to exist alongside regular full user licenses; you can request them for a new tenant or use them to replace existing full user licenses.\nPartners can purchase the unique, partner-only license via Web Direct to create flexible, cost-effective solutions that don't expire. Accessing the SKUs and pricing is simple: Go to experience.dynamics.com<https://experience.dynamics.com/requestlicense/> and submit a request for the Dynamics 365 Business Central Partner Sandbox license. Use a valid MPN ID. Once your request is approved, you receive a token to purchase the SKUs directly. Pay by credit card. If the total billing is over $500/month for your company, then you can pay by invoice.\nTo change the number of Partner Sandbox licenses on your tenant after purchasing initial licenses through experience.dynamics.com, manage your subscription in the Microsoft 365 Admin Center<https://learn.microsoft.com/microsoft-365/commerce/subscriptions/manage-self-service-purchases-users#buy-more-or-reduce-licenses>.\n### Precautions for sandbox environments with production data\nWhen an environment is created as a copy of another environment, a number of precautions are taken for that copy:\n Tasks in the job queue are automatically stopped\n  To see which scheduled jobs are stopped, and to decide which jobs to restart in the new environment, go to the Scheduled Tasks page in Business Central. There, you can set tasks to be ready to run in the job queue. However, only tasks that are marked as belonging to the current environment can run. See /admin-job-queues-schedule-tasks#view-scheduled-tasks in the business functionality content.\n All agents are copied with their tasks, but are turned off on the target environment\n  To see which agents are turned off, and to decide which agents to enable in the new environment, go to the Agents page in Business Central. There, you can enable agents as needed for the copied environment.\n Any base application integration settings are cleared\n Any irreversible features that were enabled in the original environment will also be turned on in the copy. See Features that can't be turned off<feature-management#features-that-cant-be-turned-off>.\n Development extensions that are published from AL-Go for GitHub<https://aka.ms/AL-Go> or Azure DevOps and any extensions that depend on them are uninstalled when the source environment is a sandbox. Any data that was created in the original environment by the extensions that are now uninstalled in the copy will not be deleted. Any updates to per-tenant extensions that are slotted to be upgraded with the next minor or major upgrade will be retained.\n Outbound HTTP calls from extensions are blocked by default and must be approved for each extension, otherwise instead of an external call, the system will display the following error message: The request was blocked by the runtime to prevent accidental use of production services.\n  To enable outbound HTTP calls, go to the Extension Management page in Business Central, and choose Configure. Then, on the Extension Settings page, make sure that Allow HttpClient Requests is selected. This setting must be enabled for each extension, including libraries.\n Any action taken for the purpose of complying with privacy laws and regulations must be handled separately and repeated for the environment. There is no synchronization with the original environment after the copy has been created.\n  The internal administrator has the same tools and responsibilities for the copy as they do for the original environment. As a data processor, Business Central offers the same level of data protection and data handling restrictions to all types of environments, both sandboxes and production environments.\n The following setups are set to status disabled\n   Doc. Exch. Service Setup\n   Curr. Exch. Rate Update Setup\n   VAT Reg. No. Srv Config\n   Graph Mail Setup\n   CRM Connection Setup\n   CDS Connection Setup\n   All webhooks\n   All records in the Service Connection table\n   All records in the Exchange Sync table\n The following data is cleared\n   Password in the OCR Service Setup table\n   SMTP Server in SMTP Mail Setup\n   Exchange Service URL in the Marketing Setup table\n The following changes are made for first-party extensions\n   AMC Banking 365 Fundamentals\n     The Service URL in AMC Banking Setup is reset to default for Sandbox environments\n   Email - Outlook REST API\n     All email accounts of types \"Microsoft 365\" and \"Current User\" are deleted. Deleting these records turns any existing field monitoring setup non-valid.\n   Email - SMTP Connector\n     SMTP Server details are deleted\n The following changes are made for specific localizations\n   Spain\n     SII Setup is set to disabled\n   United Kingdom\n     Password in GovTalk Setup table is deleted\n   Netherlands\n     All Digipoort related fields in the Elec. Tax Declaration Setup table are cleared\n The environment settings set in the admin center, including the Application Insights connection string and update window, are copied over to the target environment. If you don't want the target environment to emit telemetry to the same Application Insights resource as the source environment, you can remove or change the connection string after the copy completes or use telemetry-control-cost#use-data-collection-rules-dcr on the Application Insights resource to filter out telemetry from any environments from which you don't want to collect telemetry on that resource.\n If the environment is encrypted using a ../security/security-online#customer-managed-encryption-key inherited from a tenant-admin-center-environments#linked-power-platform-environment Power Platform environment, the new environment created by the copy operation will be encrypted using a Microsoft-managed encryption key. To encrypt the newly created environment using a customer-managed encryption key link it to a Power Platform environment that has the desired customer-managed encryption key applied.\n### Manage sandbox environments\nUse the Business Central administration center to manage the environments manually. See Managing Production and Sandbox Environments<tenant-admin-center-environments>.\nAlternatively, use the administration-center-api.\n### Presales performance evaluation\nIf you want to provide a prospect with an online environment where you want to demonstrate the performance and reliability of Business Central online in addition to demonstrating functionality, you must take a few extra steps.\nTo demonstrate the functionality of the default version of Business Central, without focusing on performance, you can use your own trial experience based on a Microsoft 365 demo account. We recommend that you show the full functionality of the default version by switching the tenant to the 30 day trial and the associated My Company. You can then enable the Premium user experience in the new My Company's Company Information page, populate the new company with the data required for their evaluation scenarios, and present the environment to the prospect.\nTo demonstrate the functionality of the service, with a focus on performance, you can take the same step as outlined is previous section. Except you also sign up the prospect for the Business Central Premium Trial offer, which is available through your CSP access in the Partner Center. After sign-up, wait 24 hours and then run your performance evaluation. See Preparing Test Environments of Dynamics 365 Business Central<test-environment>.\nThat 30 day trial is as close to an actual production environment performance as you can get. You only have those 29 days to run your tests and convince the prospect. But if you prepared everything in advance, you should have time enough.\nIf the prospect is convinced and decides to buy Business Central, you can then either let them keep the environment that they're currently using, or create a new production environment for them. If the tenant is yours rather than the prospect's, then a new tenant is provided to them.\nLearn more about performance and Business Central in ../performance/performance-overview.\n### Advanced user experience\nIt's possible to enable and try the full functionality of the standard version of Business Central in a sandbox environment by setting the Experience field on the Company Information page to Premium. Find the Company Information page in the menu in Business Central. However, as an admin, we recommend that you set up dedicated demonstration environments instead. See Preparing Demonstration Environments<demo-environment>.\n### Complete sample data\nThe standard demonstration company in Business Central includes sample data for a limited number of scenarios. You can also create a new company with the Advanced Evaluation - Complete Sample Data option. In this type of company, users can take training or step through walkthroughs that require more sample data, such as Walkthrough: Receiving and Putting Away in Basic Warehouse Configurations</walkthrough-receiving-and-putting-away-in-basic-warehousing>. This sample data is different from the standard sample data, and we advise that you don't capture and share screenshots with this advanced sample data.\nSee Creating New Companies in Business Central</about-new-company> in the business functionality content.\n## Related information\nManaging Environments in the Administration Center<tenant-admin-center-environments>\nPreparing Demonstration Environments<demo-environment>\nPreparing Test Environments<test-environment>\n../developer/devenv-get-started#steps-to-set-up-a-sandbox-environment-and-visual-studio-code\nGet started with the Container Sandbox Development Environment<../developer/devenv-running-container-development>\nPerformance in Business Central online<../performance/performance-online>"}