Install Docker Engine for Linux

Verify Docker is installed correctly

docker run hello-world

Install the Edge

Execute the download/installation script to install the Connect+ Edge Docker container

source <(curl -sS https://raw.githubusercontent.com/xyte-io/edge/refs/heads/main/edge_runner_script.sh)

Response return should appear as

Edge Id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

If the script does not return an ID, the relevant ID is stored in a text file and may be retrieved with the following command:

docker exec -it xyte_edge /bin/bash -c "cat edge_data/proxy_name.txt && echo"

📘
Next Step — Register the Edge in the Xyte Portal
The Xyte Portal is a separate web application — not part of Docker Desktop. Log in to your organization's Xyte Portal, navigate to Connections > Edges, and click Connect Edge to register the Edge ID you just generated.
For full instructions, see Claiming a local network device (Edge).
If you don't have portal access, contact your organization administrator.

Common issues

Error: telnet is not installed. Please install it and try again.

# Install telnet
sudo apt install telnet

docker: permission denied while trying to connect to the Docker daemon

The current user doesn't have permission to run docker containers, either run the script as sudo (not recommended) or allow user to run docker containers:

# Allow current user to run Docker without sudo
sudo usermod -aG docker $USER
newgrp docker