BCCL
====

This document only covers installation, see https://hougaard.com/bccl for all information on how to use BCCL. 

# Installation

The installation of BCCL is two-part. An extension that goes into Business Central and a command-line executable file.

## Cloud Business Central

Upload the .app file from the extension folder to your BC from **Extension Management**.

## On-premises Business Central

Use the PowerShell Publish-NAVApp to publish the extension. 
<https://docs.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/publish-navapp>

Use the -install parameter to also install the extension after publish.

## Docker-based Business Central

Use **Publish-BcContainerApp** from BCContainerHelper to publish the extension into a BC running in a Docker container.

Use the -install parameter to also install the extension after publish.

# Client installation

There's no installation for the client. The client is a single executable file, use your favorite copy command to copy the executable to "a good place".

The client support Windows, macOS and Linux, all 64bit.

(Don't be alarmed over the file size of the client executables, they are around 80mb to be completely self-contained without any external dependencies)

# Register your BCCL

Before BCCL can be used, you must register the app, this is also done through the command-line. You'll receive a **Key** that must be registered with this command:

BCCL --register **(the key you received)**

If the key is correct, you'll receive a reply stating the key was accepted.