Skip to content

Troubleshooting Guide

If you encounter an issue refer to the following list of common issues and fixes. If you cannot find a solution to the issue that you are encountering, contact IOTech Support.

Missing application configuration files in docker volume Description:
If a volume, that has had configuration injected by Edge Builder, is mounted in a location that already contains files or directories the injected files are removed.

Docker volumes should be mounted into locations that do not already contain any files.
Starting the Server Components - bind: address already in use Description:
If you start the server components and any of the ports specified for use by the Edge Builder containers is already in use by another process, docker-compose generates an error.

If you use the following command, where <controller-ip> is the IP address of the Edge Builder Controller and port 50066 is in use by another process, the eb_container container fails to start:
sudo edgebuilder-server up -a <controller-ip>
An error similar to the following is generated by docker-compose:
ERROR: for eb_controller Cannot start service eb_controller: driver failed programming external connectivity on endpoint eb_controller (f5aef4c7c92b9d1001f96c34e2f6444625f0bbda22a882f8e9b581c833569dc3): Error starting userland proxy: listen tcp bind: address already in use
To resolve this issue, identify the process using the port. If the process can be terminated, terminate the process and run the edgebuilder-server up command again.

For example, on Linux systems, you can enter the following command to see which process is using port 50066:
sudo lsof -i:50066
Logging into the CLI - Exit Code 12 (raspios-buster) Description:
Logging into the CLI on raspios-buster can cause the following error:
ERROR: Exit Code (12): mkdir /opt/edgebuilder/cli: permission denied
You must modify the ownership and permissions of the /opt/edgebuilder folder, for example, using the following commands:
sudo chown -R pi:pi edgebuilder/
chmod -R 777 edgebuilder/