The number one reason why you will only see the Home screen on the Zwift Mobile Link (ZML) app is because your computer and mobile device are not on the same network.
In order for the app to work, your phone has to be connected on the same WiFi as your computer and logged in with the same Zwift account in order for the app to show the additional in-game ride controls.
Note: You will still be able to connect a computer that's using an Ethernet cable as long as it's going through the same router that's transmitting Wi-Fi.
If you have a proxy, VPN, or enterprise-strength firewall on your computer and/or phone, it can also prevent you from connecting, so we recommend making exceptions for Zwift as appropriate.
If that doesn't apply to you, try the following:
- Make sure ZML is completely closed
- Turn on Airplane mode on your phone
- Connect to your Wi-Fi network
- Launch ZML
- Launch the Zwift game on your computer
These steps ensure that you're connecting solely over Wi-Fi versus your mobile network.
The last reason why you may be unable to connect is because you haven't updated to the newest app version. If you've turned off automatic updates or rejected updates for the app, you may be stuck with a version that's no longer supported. Visit the Play Store or iTunes store on your device to make sure that you have the newest version installed.
ZML listens on TCP port 21587. As long as you can ping your mobile device's IP and telnet successfully to 21587 when the mobile app is running, it should connect automatically when you start riding in Zwift.
Your router firewall should allow all incoming/outgoing Zwift TCP traffic on ports 80 and 443 and all Zwift incoming UDP traffic on port 3022.
My app keeps losing its connection
We cover this in a different article.
If you're still unable to connect, let us know at bit.ly/zwiftsupport