Run Your Domain Using Docker

You can run your High Fidelity domain using Docker containers. Containers are more flexible and lightweight than a virtual machine. When you launch a container, you’re running an image of the file system at a particular instance. So you will have to update the image with every latest version of High Fidelity.


Before you create a container for your domain, you will need to:

Run Your Domain in a Container

A Docker container is isolated from the rest of your system. This means that you will have to copy and communicate specific data to the container.

  1. Create an empty folder with two files: ‘.env’ and ‘hifi.yml’.

  2. The .env file contains the version of the image you want to use. To it, add the following line:


    This is the tag and needs to be updated with the release of the latest version of High Fidelity.

  3. Next, you’ll need to add information about your domain in the ‘hifi.yml’.:

    version: "3.6"
        hostname: hifi-domain-a
        image: highfidelity/hifi:${HIFI_VERSION}
          - "40100:40100"
          - "40102:40102/udp"
          - "48000-48006:48000-48006/udp"
          - "hifiVol1:/root/.local/share/High Fidelity"
      hifiVol1: {}

Here, you’re passing High Fidelity’s version number. You are also exposing the required ports for your domain to communicate with the network and let other users visit.

  1. Go to the directory in the command line tool and run the image:

    docker-compose pull # Pulls changes to files, creates volumes if they dont exist, and automatically
    docker-compose up -d # Runs all compose files at the same time, if some changes, then turns them off and replaces them with the containers created during pull.
  2. To stop running your container, run the following in the command line tool:

    docker-compose stop

Update Your Container to the Latest Version

You can update your container when a new version is released by changing the version number in the .env file.

See Also