Edge


Scenario/Error message

Likely meaning (TL;DR)

Recommended next steps

Edge agent is in error

•  Host is not connected to the network.

•  Device is not connected to the network.

•  The network is blocked to a specific type of communication.

  • Check Docker container status (running, restarting, exited)
  • Check network connectivity from the host
  • Check network connectivity from inside the container: telnet eu1.edge.xyte.io 443
  • Restart the Docker container
  • If it still failing:
    • Remove Docker and reinstall it
    • Reinstall the Edge software again (fresh install)

permission denied while trying to connect to docker api

This error means your current user account lacks the necessary rights to communicate with the Docker daemon through its Unix socket, which is owned by the root user by defaul

To fix it permanently, add your user to the docker group by running sudo usermod -aG docker $USER and then log out and back in for the changes to take effect.

You have reached your pull rate limit. You may increase the limit by authenticating and upgrading: https://www.docker.com/increase-rate-limits

https://docs.docker.com/docker-hub/usage/pulls/#view-pull-rate-and-limit

Other issues

https://docs.xyte.io/update/docs/kb-5004

"jsonrpc":"2.0","error":"code":-32602,"message":"Invalid params.","data":"Invalid parameter "/1/name": invalid host name."

In most cases, the Edge ID format is wrong, or maybe there’s a hidden character or quote

Have been attempting to add device, the Edge itself is on the same network and able to ping the device at the correct address, having checked the Docker settings I can't figure out its networking settings if it is connecting properly or not.

seems like there's no connectivity from within the internal container

For example, if the device IP is 192.168.1.99:

  1. Run docker ps
  2. Enter the xyte_edge container: docker exec -it xyte_edge bash
  3. Run docker ps again (from inside the container, if applicable)
  4. Enter the second container: docker exec -it <container_id> bash
  5. Ping the device: ping 192.168.1.99

If the Edge agent is offline

https://docs.xyte.io/docs/kb-5004

  1. Run docker ps
  2. Enter the xyte_edge container: docker exec -it xyte_edge bash
  3. Run docker ps again (from inside the container, if applicable)
  4. Enter the second container: docker exec -it <container_id> bash
  5. Execute the command: telnet eu1.edge.xyte.io 443

Proxy 'Proxy ID' already exists

Proxy id is indeed unique by design for each Edge device there is one proxy attached to it.

Need to delete the Edge agent (From the UI) that uses this ProxyID.
this will free up the used id and only after that add Edge with the same id.


I have noticed that our Edge devices have been falling offline pretty synchronically. Do you know what the cause might be for this?

  1. If the Edge agent itslef is offline please refer to: https://docs.xyte.io/docs/kb-5004
  2. If a specific devcie can't be reached you can try using the ping command in the Edge agent


What’s Next