---
title: Docker Installation
slug: bhdo/docker-installation
createdAt: 2022-03-30T21:24:33.000Z
---

You can use Docker to install Belden Horizon Data Operations. 

# Before you begin&#x20;

- Install [Docker Engine 19.03+](https://docs.docker.com/get-docker/) on an Intel 64-bit machine.
- On the Intel 64-bit machine, have administrative permissions to execute Docker commands.
- Ensure the Docker Engine is configured to run a Docker image with a root user.
- Obtain access to a Belden Horizon Data Operations Docker image, which you can get from your Belden account executive.&#x20;

To use Docker to install Belden Horizon Data Operations, you will need to do the following:

- Step 1: Launch a Belden Horizon Data Operations Docker Image
- Step 2: Log in to Belden Horizon Data Operations

# Step 1: Launch a Belden Horizon Data Operations Docker Image

**To launch a Belden Horizon Data Operations Docker image:**

1\. Request and download the service account .json file from your Belden account executive.&#x20;
2\. Open a Command Prompt Terminal (CTRL+R) on the Intel 64-bit machine.
3\. Execute the following Linux command to authenticate.

```linux
cat <file_name>.json | docker login -u _json_key --password-stdin https://us-docker.pkg.dev
```

The `<file_name>.json` parameter is the service account file from your Belden account executive from step 1.&#x20;

:::hint{type="info"}
**Example:** If the .json file is named abc123.json, execute: `cat abc123.json | docker login -u _json_key --password-stdin https://us-docker.pkg.dev`
:::

Refer to [Google's Setting Up Authentication: Service Account Key](https://cloud.google.com/artifact-registry/docs/docker/authentication#json-key) for more information.

:::hint{type="info"}
**Note:&#x20;**&#x49;f the Docker container (that will be initialized from the Docker image from Step 3) will be configured with CPU/RAM limits, allocate at least 2-4 CPUs and 4-8 GB RAM. Scale up as needed.
:::

4\. Execute the following command to initialize the Belden Horizon Data Operations Docker container from the downloaded Docker image from Step 3.

```linux
docker run --name LE -d --cap-add=NET_ADMIN -p 8443:443 us-docker.pkg.dev/litmus-sales-enablement/litmusedge/litmusedge-std-docker:latest
```

Refer to the command parameters:

- `--name LE` parameter can be changed with a different name than LE.
- `--cap-add=NET_ADMIN` parameter should not be changed as NET\_ADMIN is required.
- `-p 8443:443` parameter can be changed with a different port than 8443. Internal port 443 can be mapped to any other external port other than 8443 as desired.

5\. From the Docker terminal window, it will display the IP address to access the Belden Horizon Data Operations device through the Web UI. Enter the IP address into an internet browser URL bar to access the Belden Horizon Data Operations device.

# Step 2: Log in to Belden Horizon Data Operations

- See [Access the Belden Horizon Data Operations Web UI](https://public-docs.litmus.io/bhdo/access-the-belden-horizon-data-operations-web-ui) for details on logging in. &#x20;
- See [Access the Terminal User Interface](https://public-docs.litmus.io/bhdo/access-the-terminal-user-interface) for instructions on how to navigate and log in for the first time.

