This page describes some of the most common problems with the Monaca Debugger and how to solve them.
This is most likely a firewall problem in the host PC. The host PC needs to accept the TCP connection from the debugger. On default, the port
8001will be used, but you can change the server port in the preferences dialog. Please change the port or configure your firewall settings and then try again.
Check that your device and the host PC are connected to the same network. If they are connected to the same network but Monaca Debugger still can't detect the host PC, please do a manual pairing:
- 1.From the Monaca Debugger, open the toggle menu on the top-left corner and select
2. Click the Pair To New Computers button.
4. Once the pairing is successfully completed, the host PC should appear under
Paired computersas shown below:
Some Wi-Fi access points (usually that is available for public access) don’t allow the connected clients to communicate with each other. In this case, please try pairing on another local network.
IP address and port number are needed to establish the communication path between the Monaca Debugger and the host PC. IP address represents the host PC and port number (set to
8001by default) represents the Monaca local development tool (Monaca CLI, Localkit or Monaca for Visual Studio). Please note that the communication can't be established if the port number you use is not open or it's already used.
If you are using more than one of Monaca local development tool at the same time on the same host PC, you are required to use a different port for each tool.
Finding the IP Address
Check if a port number is available
When using a custom build debugger on Android 9 or later, you need to add the Android namespace to the
applicationtag in the
Create a custom build debugger after adding the settings to the
If you are using an Android custom build debugger v9.0.1 or later, these settings are not required.
<edit-config file="AndroidManifest.xml" target="/manifest/application" mode="merge">
<application android:usesCleartextTraffic="true" />