Guides

Ubuntu / Debian Installation Guide

1. Install Telnet

sudo apt install telnet

  1. Setup the Docker APT Repository
# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

  1. Install the Docker Packages
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  1. Verify the installation was successful by running the 'hello-world' image
		sudo docker run hello-world

3. Docker Post-Installation Steps

  1. Create the Docker Group
sudo groupadd docker
  1. Add your user to the docker group
sudo usermod -aG docker $USER
  1. Activate changes to the group
newgrp docker
  1. Verify you can run the docker commands without Sudo
docker run hello-world

4. Install the Connect+ Edge 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"