topic hubAdministration & Setupofficial - Microsoftreviewed - checked by Opus

Work in sandboxes

Sandbox environments for Business Central AL development: how online and container sandboxes differ, how to run a container-based environment with Docker and BCContainerHelper, and how to test extensions under different user plans and entitlements.

Path: Development > Development environment > Work in sandboxes · tier official · system administration · narrative reviewed (checked by Opus)

Overview

This section covers the sandbox options developers use to build and test Business Central extensions. It compares online sandboxes, managed by Microsoft, with container sandboxes hosted on an Azure VM or on-premises, and describes what each allows, such as production data upload, Designer, debugging, database access and tools like Visual Studio Code and C/SIDE.

For a local setup, one page walks through running a container-based development environment with Docker, Windows containers and the BCContainerHelper PowerShell module. It covers creating and managing sandbox containers and installing apps. It references 2026 release wave 1 and version 28.0.

A third page explains how to set up a development sandbox with different user plans and license types. This lets you check that an extension works across subscription tiers. Start with the comparison page to choose a sandbox type, then use the container or entitlement page as needed.

Key points

  • Two sandbox types are compared: online (managed by Microsoft) and container (Azure VM or on-premises).
  • The comparison covers deployment options, production data upload, Designer, debugging and database access.
  • Container sandboxes are set up with Docker, Windows containers and the BCContainerHelper PowerShell module.
  • The container guide covers creating and managing sandbox containers and installing apps, and references 2026 release wave 1 and version 28.0.
  • Entitlement testing uses user groups, permission sets, subscription plans and license assignment.
  • Test users can be set up with different plans to verify extension behavior across subscription tiers.

Learn pages

Videos and posts

Linked by a Haiku matcher with a grounding quote from the item’s summary (link/topics.ts); machine-generated.

Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.

What Learn documents here 3 Learn pages