LOCAL_DEV_ENV.md

How to create a local development environment

Prerequisites

• Install and run Docker Desktop. Make sure it is running Windows containers.
• Install BcContainerHelper PS module (latest available version). Install-Module BCContainerHelper -AllowPrerelease would do.

Here you can read more about BcContainerHelper.

Create a development environment

The development environment is a docker container running Business Central locally. In order to create it, simply run .\build\scripts\DevEnv\NewDevEnv.ps1 with the desired parameters.

For instance, running the following will

1. Build all AL apps that match .\src\System Application\.
2. Create a docker container called BC-SystemApp with an admin user with the provided credentials.
3. Publish the built apps and their dependencies to BC-SystemApp.

.\build\scripts\DevEnv\NewDevEnv.ps1 -containerName 'BC-SystemApp' -userName admin -password '<some password>' -projectPaths '.\src\System Application\*'