Skip to main content
All CollectionsTroubleshooting
Troubleshooting Agent Issues
Troubleshooting Agent Issues

Guide for resolving common Level agent installation and connectivity issues, like firewall configurations.

Updated over 2 months ago

Level is easy to install, but sometimes there are issues.

The Level agent is currently available for Windows, Mac, and Linux. For details on installing Level please see those respective pages. There are a few network items to consider for the agents to check and function successfully.

Restart Level Agent

  • Windows: Restart-Service -Name Level

  • macOS: sudo launchctl kickstart -k system/Level

  • Linux: systemctl restart Level

Check the Firewall

To ensure reliable peer-to-peer communications and overcome potential connectivity issues in highly restricted networks, Level utilizes Twilio's Network Traversal Service. Please note that these modifications should only be implemented on highly restricted networks where establishing a peer-to-peer connection becomes problematic or time-consuming. In most cases, Level operates without the need for firewall changes.

You may want to modify your network infrastructure to allow connections to and from the below addresses on the following ports:

Port

Protocol

Purpose

80

TCP

HTTP

443

TCP

HTTPS

3478

TCP & UDP

TURN

5349

TCP

TURN TLS

10,000-60,000

UDP

Twilio's TURN servers will allocate peer relay ports in this range.

The following URLs are used

  • agents.level.io (used by the agent to communicate with Level)

  • online.level.io (used to check connectivity status)

  • builds.level.io (used for agent updates)

  • downloads.level.io (used for initial agent install)

  • realtime.ably.io (maintains real-time WebSocket to endpoints for Level API)

  • global.turn.twilio.com (used when peer-to-peer connections cannot be made for remote control)

  • global.stun.twilio.com (used when peer-to-peer connections cannot be made for remote control)

By making these adjustments, you can enhance Level's connectivity and minimize potential disruptions, ensuring a smooth and reliable peer-to-peer communication experience.

If your firewall supports wildcard URLs, it might be helpful to allow .level.io and .twilio.com.

Ensuring Keyboard Functionality in Hyper-V

If the device running Level is a virtual machine in Hyper-V, you may need to adjust the keyboard settings to ensure proper functionality. Specifically, configure the Keyboard setting in the VM’s settings to direct Windows key combinations to the virtual machine. This adjustment ensures that keyboard shortcuts like ALT + TAB work correctly within the VM.

Did this answer your question?