{"title":"Working with development sandboxes and entitlements","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-work-sandbox-entitlements/","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/developer/devenv-work-sandbox-entitlements, 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/developer/devenv-work-sandbox-entitlements","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 development sandboxes and entitlements.","date":"2024-01-04","meta":{"topic":"concept-article"},"outline":[{"level":1,"title":"Working with development sandboxes and entitlements","slug":"working-with-development-sandboxes-and-entitlements","at":0,"chars":6499},{"level":2,"title":"Setup for users with different plans","slug":"setup-for-users-with-different-plans","at":1131,"chars":2123},{"level":2,"title":"Assigning the Premium plan to test users","slug":"assigning-the-premium-plan-to-test-users","at":3254,"chars":2870},{"level":3,"title":"Azure VMs","slug":"azure-vms","at":3397,"chars":458},{"level":3,"title":"BCContainerHelper","slug":"bccontainerhelper","at":3855,"chars":1123},{"level":3,"title":"Docker run","slug":"docker-run","at":4978,"chars":1146},{"level":2,"title":"Related information","slug":"related-information","at":6124,"chars":375}],"text":"# Working with development sandboxes and entitlements\nThe experience that a user has in Dynamics 365 Business Central depends on the purchased subscription plan. In Dynamics 365 Business Central, there are two main plans; the Essential and the Premium plan, plus a few more. See Licensing in Dynamics 365 Business Central<../deployment/licensing>. For detailed information about the Essential and Premium plans, see Business Central<https://www.microsoft.com/dynamics-365/products/business-central/> on the Microsoft Dynamics 365 site.\nWhen you develop in a Docker sandbox, the Essential experience is automatically assigned to you (you set the experience on the Company Information page), which makes it difficult to test how a user with the Premium plan assigned will experience what you have developed.\n> NOTE\n> There is no license check in a Docker Sandbox except for on Purchase and Sales documents. There is a different behavior in these documents as the TEAMMEMBER license has partial access. In particular Invoices, Orders, Quotes and Credit Memos share the same table and the TEAMMEMBER license has access only to Quotes.\n## Setup for users with different plans\nTo mimic users with a specific subscription plan assigned, you can set them up with the user groups as detailed in the table below. When you add user to the group, the permission sets defined for the group will apply to the user. See /ui-define-granular-permissions#to-manage-permissions-through-user-groups.\n> NOTE\n> In the table below non-default means not assigned by default, but the plan allows this to be assigned to the user.\nUser Name <br>The type of subscription plan <br> assigned to the given user|User Groups\nEXTERNALACCOUNTANT<br><br>Dynamics 365 Business Central External Accountant|D365 EXT. ACCOUNTANT<br>EXTEN. MGT. - ADMIN (non-default)<br>D365 TROUBLESHOOT (non-default)<br>D365 SECURITY (non-default)\nPREMIUM<br><br>Dynamics 365 Business Central Premium<br>Dynamics 365 Business Central for IWs|D365 BUS PREMIUM<br>EXTEN. MGT. - ADMIN (non-default)<br>D365 TROUBLESHOOT (non-default)<br>D365 SECURITY (non-default)\nESSENTIAL<br><br>Dynamics 365 Business Central Essential|D365 BUS FULL ACCESS<br>EXTEN. MGT. - ADMIN (non-default)<br>D365 TROUBLESHOOT (non-default)<br>D365 SECURITY (non-default)\nINTERNALADMIN<br><br>Internal Administrator|D365 INTERNAL ADMIN<br>D365 TROUBLESHOOT<br>D365 BACKUP/RESTORE<br>D365 SECURITY (non-default)\nTEAMMEMBER<br><br>Dynamics 365 for Team Members|D365 TEAM MEMBER<br>D365 TROUBLESHOOT (non-default)<br>D365 SECURITY (non-default)\nDEVICE <br><br>Dynamics 365 Business Central Device|D365 FULL ACCESS<br>EXTEN. MGT. - ADMIN (non-default)<br>D365 BUS PREMIUM (non-default)* <br>D365 TROUBLESHOOT (non-default)<br><br>D365 SECURITY (non-default)<br><br> *) Please note: usage need to be according to terms in Licensing Guide\nDELEGATEDADMIN<br><br>Delegated Admin agent - Partner<br>Delegated Helpdesk agent - Partner|EXTEN. MGT. - ADMIN<br>D365 FULL ACCESS<br>D365 RAPIDSTART<br>D365 BACKUP/RESTORE<br>D365 TROUBLESHOOT<br>D365 SECURITY (non-default)\n> TIP\n> For more information about how to choose a user experience, see Changing Which Features are Displayed</ui-experiences#choosing-a-user-experience-to-show-or-hide-features>.\n## Assigning the Premium plan to test users\nDepending on how you are running your Docker sandbox, you assign the experience in different ways.\n### Azure VMs\nIf you use https://aka.ms/bcsandbox<https://aka.ms/bcsandbox> to create your Dynamics 365 Business Central Sandbox Container Azure VM, the Azure Resource Manager template has two fields; Assign Premium Plan and Create Test Users, which by default are set to Yes.\nAssign Premium Plan specifies whether or not your admin user should be assigned a Premium plan. Create Test Users specifies whether or not you want the setup to include test users.\n### BCContainerHelper\nIf you're using `New-BCContainer` to create your Dynamics 365 Business Central Sandbox container, you must make sure that you're using version 0.2.8.3 or later.\nUse the switch assignPremiumPlan on `New-BCContainer` like this:\n```powershell\nNew-BCContainer -accept_eula -updateHosts -containerName test -artifactUrl (Get-BCArtifactUrl -country us) -assignPremiumPlan\n```\nThis assigns the Premium plan to your default admin user. Internally this just adds a record to the User Plan table.\nTo create the test users, you must call the `Setup-BCContainerTestUsers` method:\n```powershell\nSetup-BCContainerTestUsers containerName test -tenant default -password $securePassword\n```\nspecifying the container and the password that you want to use for the new users.\nInternally, the `Setup-BCContainerTestUsers` downloads an app that exposes an API, publishes and installs the app, and then invokes the CreateTestUsers API with the password needed. After this, the app is uninstalled and unpublished.\nIf you want to see code behind the app, it's available https://github.com/businesscentralapps/createtestusers.\n### Docker run\nIf you're using Docker run to run your containers, you have a little more work to do.\nFirst of all, you must override the SetupNavUsers.ps1 by sharing a local folder to `c:\\run\\my` in the container and place a file called SetupNavUsers.ps1 in that folder with the following content:\n```powershell\n# Invoke default behavior\n. (Join-Path $runPath $MyInvocation.MyCommand.Name)\n\nGet-NavServerUser -serverInstance $ServerInstance -tenant default |? LicenseType -eq \"FullUser\" | ForEach-Object {\n    $UserId = $_.UserSecurityId\n    Write-Host \"Assign Premium plan for $($_.Username)\"\n    Invoke-Sqlcmd -ErrorAction Ignore -ServerInstance 'localhost\\SQLEXPRESS' -Query \"USE [$TenantId]\n    INSERT INTO [dbo].[User Plan`$63ca2fa4-4f03-4f2b-a480-172fef340d3f] ([Plan ID],[User Security ID]) VALUES ('{8e9002c0-a1d8-4465-b952-817d2948e6e2}','$userId')\"\n}\n```\nThis will assign the Premium plan to the admin user in the database.\n> TIP\n> To set up test users, you can clone the https://github.com/businesscentralapps/createtestusers repository and modify the code to create the users on the oninstall trigger with the password that you want.\n## Related information\ndevenv-programming-in-al\nSandbox Environments for Dynamics 365 Business Central Development<devenv-sandbox-overview>\nContainer Sandbox<devenv-running-container-development>\nChanging Which Features are Displayed</ui-experiences#choosing-a-user-experience-to-show-or-hide-features>\nProduction and Sandbox Environments<../administration/environment-types>"}