Skip to main content

Troubleshooting installation issues

Updated over 4 months ago

Installation issues

“bind: address already in use” Error

> sudo docker compose -f compose.yml up -d 

[+] Running 0/2
⠹ Network edgevis-encoder_default Created 0.3s
⠙ Container edgevis-encoder Starting 0.2s
Error response from daemon: driver failed programming external connectivity on endpoint edgevis-encoder (...): Error starting userland proxy: listen tcp4 0.0.0.0:8443: bind: address already in use

If this error is reported when the container is being started, this is due the the port configured (8443 by default) being already in use by an existing edgevis container or another application.

How do I know my EVVR Container is running?

Step 1 - Check if the web interface is running

The web address for your container (using default settings) will take the format:

  • https://[ip address of host machine]:8443/

The :8443 signifies that the web service for your EVVR Container is on a non-standard port, chosen to avoid clashes with any (potential) existing web server running on your host machine.

Enter your host machine's IP address into your web browser, using the above syntax. Your browser will signify an issue with the SSL certificate - this is expected behaviour as the web service is using a self-signed certificate, and you must accept this warning to proceed to the login page.

If you can access the web interface, your instance of EVVR Container is up and running.

If you can't, then please repeat the step using a web browser on the same machine as your instance of EVVR Container using this address:

If the works, but you can't access the web interface on another machine then you are likely to have a networking/firewall issue.

Step 2 - Check if Docker is running your EVVR Container

Log into a terminal on the machine that is hosting your instance of EVVR Container. You will need an account that can run commands under sudo.

Check 1 - Enter the following command:

sudo docker ps

You should see an edgevis/encoder entry:

CONTAINER ID   IMAGE                   COMMAND             CREATED     ...   
27fa230fea0c edgevis/encoder:latest "/usr/bin/ipseries" 8 days ago ...


If you see this then your docker container is running for EVVR Container.

Check 2 - Another check is that the ipseries program needs to be running. To check this, use this command:

ps -ef | grep ipseries

There should be a process called ipseries listed, otherwise you will receive no output:

root 108282 108262 0 10:14 ? 00:00:01 /usr/bin/ipseries

If both of these checks pass... then EVVR Container is up and running successfully.

If both of these checks fail... then you likely have an installation issue and should reinstall. If this fails again then please contact us for support.

Otherwise... if the container shows up in the ps -ef command but not in the docker ps command this could mean that there are multiple versions of docker installed on the host system.

This can happen on Ubuntu if docker was installed using snap when the OS was installed.

Check if the docker snap is installed:

sudo snap list docker

If the docker snap is installed the output will look like this:

docker 27.2.0 2963 latest/stable canonical✓ -

To remove the snap run this command:

sudo snap remove docker sudo reboot

Did this answer your question?