Install Docker Engine for Linux

Verify Docker is installed correctly

docker run hello-world

Install the Edge

1. 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)

2. 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"

4. Register the Edge in the Xyte Portal

📘

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

The install command prints nothing and never returns

The script first checks that it can reach eu1.edge.xyte.io on port 443. When that connection is silently dropped, the check hangs and nothing is printed. The usual causes are an outbound firewall rule, or a host that only reaches the internet through an HTTP proxy — the Edge cannot use a proxy and needs a direct outbound route on port 443. See Networking requirements and ask your network team for a direct egress rule for this host.