Changing the way you run Business Central in docker…

Update 2021/2/10: BcContainerHelper has replaced NavContainerHelper. This blog post still reference NavContainerHelper, which is outdated.

Just as you thought you were getting the hang of running Business Central in docker, then you see this title! Your first thought is probably how big the changes are to your pipelines and to your scripts and how much time you will have to perform these changes.

Easy now!

Nothing will have to change overnight – everything that worked yesterday should still work and you will just be able to run Business Central in docker in a new way starting today…


The big change is, that Microsoft will stop producing docker images and instead publish builds as artifacts, which can be used together with the generic docker image to run the image you want.


There are a number of reasons why this change is being done. If we look at how Business Central images are built, then the generic image is SQL Express, IIS and some PowerShell scripts added to dotnet/framework/runtime.

On top of that we add a w1 layer for every version of Business Central and on top of that a number of local images (20 for onprem).

When running an image like this, it works best if you are using the same OS Version for windows/servercore and he host (see more here: In fact we have had multiple problems with people running different versions causing all kinds of issues. For some time, we tried to build the images on the version of windows/servercore giving the least amount of issues, but our MS security team is telling us, that we cannot use old and un-patched versioins of windows/servercore – it is a security risk, and I cannot really argue against that.

Even worse – I know of partners who are trying to not update their host machines in order to avoid compatibility problems with new updates.

The fact sheet for explaining the support for Windows OS’ can be found here: – ltsc builds are supported for 10 years, sac builds for 18 months. Every supported build will get new cumulative updates every month. While writing this, there are 8 supported versions of Windows supported for Docker (host and container OS).

Every time a new windows/servercore is shipped (8 every month), the dotnet framework team ships a new image based on that windows/servercore, and every time a new dotnet/framework/runtime image is published we publish a new generic image (the layer with SQL Express, IIS and PS Scripts).

That is all goodness, that is manageable.

The problem comes if we are to continue the rebuild up the chain. While writing this, there are 176 w1 on premises images out there and there are 20 localizations on top of these – giving a total of 3500+ images and new images are added every month (and then we haven’t even counted the sandbox images and the daily builds). If we were to build these for every new version of the generic layer, every month – we would have to build 28.000+ images every month and publish these (that would be ~280 Terabytes of images every month) and a lot of these images would probably never be used.

So, lets go back to where things were manageable – we build the generic images and use these. This is where I added the -useBestContainerOS parameter. This parameter worked like this:

  1. You pull the image you want to run
  2. You extract the artifact from that image (binaries, database, apps etc.)
  3. You pull the generic docker image
  4. You share the artifacts with the container
  5. You run the generic image with these artifacts

That works, but isn’t really efficient.

The specific docker image is ~10Gb (~15Gb for ltsc2016). The Generic image is ~6Gb and since the generic is build on a different windows/servercore – you always have to download both.

You are actually downloading ~10Gb of docker image for the soul purpose of extracting artifacts (which are around 1Gb in size)

Adding to that, docker images are not the best artifact cache and cleanup etc. is cumbersome.

So in the future, we will be publishing artifacts instead of docker images. Artifacts will be available through a CDN for very fast download and is fully integrated in NavContainerHelper and the generic docker image, the process will instead look like this:

  1. Pull the generic image
  2. Run the image with a parameter specifying where to find the artifacts
  3. Download the artifacts during run

Using the ContainerHelper, it will actually download the artifacts beforehand and cache them on the host computer.


The very first thing you need to do is, to update the NavContainerHelper to or later. The next thing you need to do is to find the artifactUrl. There is a function for this:

$artifactUrl = Get-BCArtifactUrl -version 16.2 -country us -select Latest

This will give you the artifactUrl for the latest 16.2 Business Central sandbox artifacts. This artiactUrl can be passed directly to New-BcContainer instead of the imagename:

The running container should work EXACTLY like a running container based on an image, it just takes a little longer to start.

When can I try this?

You can try this out today. The generic images are out there and NavContainerHelper is supporting this. All existing on-premises artifacts have been published (-type onprem on Get-BcArtifacts) and a number of the later sandbox artifacts.

Do play around with Get-BcArtifactUrl and Get-NavArtifactUrl to get artifactUrls for the various versions of Business Central and NAV. Try to run them and see if everything works as it used to do – it should.

If you experience issues, please file issues here: and remember to pass the full script and the full output of the script – that will help me identify why things didn’t work as expected.

When do we switch over?

If everything goes as planned, July update will be the last image, which gets published as a docker image. After this, the docker images will stay for a while to ensure that everybody using them have had a chance to switch.

Insider images will also become available as artifacts and will be published more frequently, faster and more reliable than docker images. Insider images stop being published as docker images in July as well.

What now?

As you can imagine, a lot of documentation will need to change. A lot of blogs and how-tos will need to be updated, CI/CD documentation etc. etc. – I will work on that for the next weeks.

I will also monitor the NavContainerHelper issues list to see if things are running as expected.

and… – the next blog posts will go more into detail about the new functions and how things really works.


Freddy Kristiansen
Technical Evangelist

52 thoughts on “Changing the way you run Business Central in docker…

  1. great update! – looks like process isolation is working again on my win 10 😀 😀 😀
    is there any way to pull NAV 2018 CUxx Images without knowing the build no?
    it’s hard to explain to our users, that they must know the build know (or look them up)


  2. Pingback: Working with artifacts | Freddys blog

  3. Hi, Freddy.

    Thanks for everything first. I have two questions, see if you can help me.

    We have a development done with the version’s this version is not in the artifacts Do you know if they will upload more versions in the next days?

    And the other one. In your Azure templates are you going to use artifacts?

    Thank you very much.


  4. Pingback: Changing the way you run Business Central in docker… |

  5. Pingback: Working with artifacts |

  6. It may be a stupid question – so you are allowed to drop a stupid answer 🙂

    What is the deal with the “generic image” … I mean, what’s inside of it that it needs to be such a “god image” ? Well, obvious it keeps your tools inside (aren’t they similar to an artifact as well?)

    I guess the idea is also to take away a bit the complexity that people would need to go through… just curious if you see any chance that this “godness” will disappear? Or in other words what would it take to get the same stuff running without using the generic image 🙂


      • There are absolutely no secrets here – the generic image has always been the foundation of the other images and has always been open source.
        It is just like a VM with dotnet, IIS, SQL Express and other pre-requisites installed – and then the installation scripts from the nav-docker repo (as you found).
        Earlier it wasn’t really possible to modify since all images was build on top of this – now, you can.


  7. Pingback: Creating a Dynamics 365 Business Central Docker container with artifacts on Azure Container Instances - Dynamics 365 Business Central Community

  8. Pingback: July updates are out – they are the last on-premises docker images | Freddys blog

  9. Pingback: July updates are out – they are the last on-premises docker images - Dynamics 365 Business Central Community

  10. Pingback: Working with artifacts - Freddy's Blog - Dynamics 365 Business Central/NAV User Group - Dynamics User Group

  11. Pingback: ArcherPoint Dynamics NAV Business Central Developer Digest - vol 303 - Microsoft Dynamics NAV Community

  12. Hi Freddy,
    Not sure this is the right place for this question, but I can’t get the next major and next minor artifact urls.
    $artifact = “bcartifacts/sandbox//us/SecondToLastMajor”
    resulting artifact url is
    $artifact = “bcartifacts/sandbox//w1/Latest”
    resulting artifact url is
    Am I doing something wrong?
    Thanks in advance!


  13. Hi Freddy, thank you for your blog!!

    I have a question, How could I download the generic docker image before get the artifact?

    Thanks in advance 🙂


  14. A bit confusion:
    We run the
    install-module navcontainerhelper -force
    Update-Module navcontainerhelper -Force
    We get the following message from the script:
    NavContainerHelper is version

    How do we get the necessary update to


  15. Is this a good change? Yes.
    However, I think the switch was fast. Too fast. 1 month turn around? Jfc. No real communication unless you follow this blog. It’s kind of insane to me that we weren’t given more time, more notice, communication elsewhere.
    Not great.


  16. This may not be the proper place to ask this but i looked and could not find it… I tried setting up a working container of Dynamics365 to play with VSCode and do some development.

    I first tried the sandbox but i could never load the symbols.

    Then i went to docker and downloaded the Businesscentral Sandbox (docker pull

    Took a while but when i tried to

    docker run -e accept_eula=Y -m 4G

    it gave me errors.

    Then I found Creating your Workshop environment here and followed the instructions using the template to create an Azure VM. but the status is stuck

    5:07:54 PM Launch SetupVm
    5:07:52 PM Register RestartContainers Task to start container delayed
    5:07:46 PM Using BcContainerHelper version 1.0.4
    5:07:05 PM Installing Latest Business Central Container Helper from PowerShell Gallery

    for one hour and monitoring activity on portal shows almost no cpu activity last hour, so it looks like nothing is happening.

    I will try docker again as maybe i didnt do something right, but i am getting a bit discouraged.


    • Create on online trial sandbox and use VS Code with that – that is very very easy to get started with.
      If you want docker – use the powershell module BcContainerHelper and use the New-BcContainerWizard function to help you create a container with the right settings.


  17. Hi Freddy
    Having issues get any artifact for BC13. Is there a trick? I have tried a number of combinations but nothing seems to work.
    Get-BCArtifactUrl -version ‘13.1’ -country ‘gb’
    Get-BCArtifactUrl -version ‘13.0.25940’ -country ‘gb’
    using a recent BCContainerHelper (was latest as of 2020/09/21)
    BCContainerHelper 1.0.6 installed


  18. Pingback: Where to find the Microsoft Dynamics 365 Business Central (and NAV) Docker Images (updated)

  19. Pingback: Troubleshooting Business Central on Docker | Freddys blog

  20. Pingback: Troubleshooting Business Central on Docker - Freddy's Blog - Dynamics 365 Business Central/NAV User Group - Dynamics User Group

  21. Hello Freddy,

    I have created with an Azure VM (navserver) and now I want to create an new container in this VM (navserver2) stop the old one and acces to the new one the same way that before trought the landing page.

    Looks that using -PublicDnsName and -useSSL is not enough, could you give me some hints ?



    • In the BcContainerHelper PowerShell prompt, you can use Replace-BcServerContainer -artifactUrl $artifactUrl to replace the existing container with a new with the same settings.
      Alternatively you should enable traefik on the VM (when created) then all containers become accessible on the landing page.


  22. Pingback: Docker Artifacts - theDenSter

  23. Pingback: Removing all specific NAV and Business Central Docker Images | Freddys blog

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s