Connection Troubleshooting (Linux)

Once Immersed is installed on your headset and computer, start them up and follow the in-app steps to connect.


If you see “Connection Failure…”, the headset and computer cannot see each other on your Local Area Network (LAN).


#1 Recommendation: Try Wi-Fi Direct to side-step all connection issues and minimize latency!


Please check your firewall setup (ie., firewalld, iptables, etc.).

We use TCP port 21000, and UDP ports 21000 & 21010. If you run firewall apps, please disable them temporarily (to diagnose) and try again.

If it’s working after the firewall is disabled, your firewall is the main blocker. We recommend to enable again and add a rule to your firewall to let Immersed through.

Examples

firewalld

firewall-cmd --permanent --add-port=21000/TCP

firewall-cmd --permanent --add-port=21000/UDP

firewall-cmd --permanent --add-port=21010/UDP

iptables

sudo iptables -I INPUT -p tcp --dport 21000 -j ACCEPT

sudo iptables -I INPUT -p udp --dport 21000 -j ACCEPT

sudo iptables -I INPUT -p udp --dport 21010 -j ACCEPT


Please check whether if other processes are using our ports or not.

If other ports are taken, we cannot allocate the same port number.

Please try the command below to check any other apps are using the same ports.

sudo netstat -tulpn | grep -e 21000 -e 21010


If you use a VPN, please disable and try again.

We currently don’t support different networks between agents and VR headsets. When you run your VPN, the agent might think it’s on a different network and can’t be found by the VR headset.

If you still want to use a VPN at the same time, it might be possible to connect when you set your agent IP address forcibly.

1. Please open the “~/.ImmersedConf” file and find the “ForceIPAddress”: “YOUR_IP” line.

2. Then replace YOUR_IP with your Linux PC local IP address, found by typing the ifconfig command into the Terminal.


If none of these steps help, please send your username and zipped log files from “~/.Immersed/Logs” to our support team at support@immersed.com