Installing Milestone AI Bridge (docker compose)
Milestone AI Bridge can be deployed, maintained and operated using Kubernetes or docker compose to manage the Milestone AI Bridge containers. This section of the Milestone AI Bridge documentation describes how you can use Docker Compose to do this.
Linux and Windows
The majority of Intelligent Video Analytics (IVA) applications are designed as Linux programs and run on various Linux distributions. For this reason, the processing server will invariably utilize a Linux operating system, typically Ubuntu Linux, while the XProtect Management Client requires the Microsoft Windows operating system.
The installation and configuration instructions will therefore be different depending on the operating system.
Download the Docker Compose resource file
The docker compose resource file is a part of the Milestone AI Bridge resource file and must be downloaded from the Milestone download page.
For more information about where to download Milestone AI Bridge resources, see Milestone AI Bridge resource location.
The docker compose resource file is a zipped file and is named aibridge_compose_deployment.zip.
The resource file contains all the resources required to deploy Milestone AI Bridge using docker compose and consists of the following resource files:
| Folder | Sub-folder | Files |
|---|---|---|
| certs | tls-ca |
|
| certs | tls server |
|
| config | register.graphql | |
|
You can use the SCP command line utility or the WINSCP file manager to copy files to and from your Linux host machine and a Windows machine.
Install docker compose
On your machine, open a terminal and run the following command to install docker:
sudo apt install -y curl; \
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -; \
repo="https://download.docker.com/linux/ubuntu"; \
sudo add-apt-repository "deb [arch=amd64] ${repo} $(lsb_release -cs) stable"; \
sudo apt update; \
sudo apt install -y docker-ce; \
sudo gpasswd -a $USER docker
Install Lazydocker (optional)
You can also install the Lazydocker tool. Lazydocker is a tool with a terminal UI for both docker and docker compose that can help you keep track of all the running containers.
On your machine, open a terminal and run the following command to install Lazydocker:
base="https://github.com/jesseduffield/lazydocker/releases/download/v0.23.0"; \
file="lazydocker_0.23.0_Linux_x86_64.tar.gz"; \
wget ${base}/${file}; \
sudo tar -zxvf ${file} -o -C /usr/local/bin lazydocker; \
rm ${file}
LazyDocker can only be accessed from the processing server.
Configure your DNS infrastructure
Your DNS infrastructure must be configured correctly for Milestone AI Bridge communication.
When configuring your DNS, the following things must be kept in mind:
-
The machine running the Milestone AI Bridge (typically the Ubuntu machine) must be able to access all XProtect machines using machine IP addresses or hostnames.
-
All machines running XProtect must be able to access the Milestone AI Bridge machine using the Milestone AI Bridge machine hostname or IP address.
Configure the XProtect Management Client machine
You must configure the XProtect Management Client to communicate with the processing server through the Milestone AI Bridge.
If you have not yet installed the Milestone XProtect Processing Server Admin Plugin on your XProtect Management Client machine, you should do so now. See Install the Milestone XProtect Processing Server Admin Plugin for more information.
To configure your XProtect Management Client for communication with the processing server you must also create an XProtect basic user and assign the new basic user the administrator role.