---
title: Installing a New Docker Image
slug: zixi-broadcaster-zec-current-version/uBFM-installing-a-new-docker-image
docTags: 
createdAt: 2024-12-22T17:07:37.531Z
---

You can either install a Docker image by downloading a saved Docker image file directly from the Zixi Customer Portal, or you can download a regular Linux installation file for the Broadcaster and then build your own Docker image.

### To download a Docker image file:

::::WorkflowBlock
:::WorkflowBlockItem
Access the Zixi Customer Portal at [Zixi Customer Portal](https://portal.zixi.com/).
:::

:::WorkflowBlockItem
Log in using your *Username* and *Password*.
:::

:::WorkflowBlockItem
In the Main Navigation, click **Software**.
The available software versions for Zixi Broadcaster (which are available for your account) are displayed towards the top of the page. The “linux64” build is an X86\_64 build that should run on any Intel or AMD X86\_64 CPU system.
:::

:::WorkflowBlockItem
Click on the box of the version that you would like to install.
The download options for the selected version are displayed.

::Image[]{src="https://api.archbee.com/api/optimize/mzxtTQEvCNIdUNgF2kuwJ/wfQ7tOtgXcgViAIg-JOWz_image.png" size="70" width="1311" height="629" position="center" darkWidth="1311" darkHeight="629" showCaption="false"}
:::

:::WorkflowBlockItem
To download the Docker image file, click on the **Download** button next to the Docker file and navigate to the location where you would like to save the file.
Alternatively, you can download the Docker image file by clicking on the **>\_CLI** button next to the Docker image file and executing the `wget` command that is provided.
:::

:::WorkflowBlockItem
Extract the installation file by typing the following command:&#x20;

```bash
gzip -d <zixi_product>-<version_number>.docker.tar.gz
```

where `<zixi_product>` is “zixi\_broadcaster” and `<version_number>` is similar to “16.4.44543”.
:::

:::WorkflowBlockItem
Import the .tar Docker file image into your local Docker environment using the load command as shown below:

```bash
docker load --input <zixi_product>-<version_number>.docker.tar
```

At this point the Docker image is defined in your the local environment, but the Docker container is not yet running
:::
::::

### To build a new Docker image:

::::WorkflowBlock
:::WorkflowBlockItem
Copy the contents of [Appendix A](docId:39cP1cpAafwr1k68k9eUB) and [Appendix B](docId\:KsEY4ljPoa-Z-p30yC92N) into files named “dockerfile\_zixi\_broadcaster.txt” and “broadcaster-config-template.xml”, respectively.
:::

:::WorkflowBlockItem
Place the files into the current working directory.
:::

:::WorkflowBlockItem
If you don’t already have the required installation file, you can obtain following the steps in [the section above](docId\:uBFM4G3PsqVgURGW6ULDU).
:::

:::WorkflowBlockItem
Copy the Broadcaster .tar.gz installer file into the working directory.
:::

:::WorkflowBlockItem
Edit the dockerfile\_zixi\_broadcaster.txt file with the correct version number for the Broadcaster installer.

::Image[]{src="https://api.archbee.com/api/optimize/mzxtTQEvCNIdUNgF2kuwJ/0p4Xiln4-hOO7eLwK7SQE_image.png" size="64" width="645" height="175" position="center" darkWidth="645" darkHeight="175" showCaption="false"}
:::

:::WorkflowBlockItem
Run the following Docker build command, which will execute steps in the specified Docker file.

```bash
docker build --no-cache --tag <zixi_product>-<version_number> --file ./dockerfile_zixi_broadcaster.txt .
```

The dockerfile\_zixi\_broadcaster.txt file contains embedded comments describing how the image is being built. After the image is built, you will have an image in your local Docker environment.
:::

:::WorkflowBlockItem
Use the following command to see available images:

```bash
docker images
```

The output will be similar to the following (with different image IDs):

```bash
REPOSITORY 		     TAG		IMAGE ID	     CREATED		SIZE
zixi broadcaster	16.4.44543	855f142a53a7	24 minutes ago	549MB
centos	            7		    B5b4d78bc90c	5 weeks ago		203MB
```
:::

:::WorkflowBlockItem
After building the Docker image, you can save the image to a file that can be easily shared to someone else. To save the image to a file, use the save command as shown below:

```bash
docker save zixi_broadcaster:<version_number> > zixi_broadcaster-<version_number>.docker.tar
```
:::

:::WorkflowBlockItem
You can use the repository and tag to specify the image, as shown above, or you can use the image ID.
:::

:::WorkflowBlockItem
After saving the image, you can “gzip” it to save space
:::
::::



