If you are unable to progress past the Network Test, or you see this error: “We're sorry, but your router will not support JamKazam in its current configuration” this is an indication that there is something unusual on your network that is keeping you from connecting with other JamKazam musicians.
We have put a lot of work into making JamKazam very smart at setting up solid, low-latency network connections. For most users on normal home networks, JamKazam “just works” with their router and Internet service with no work required. However, something on your network is atypical, and unfortunately it will require some additional effort and patience to overcome this obstacle.
Here are the general steps we recommend. Scroll down for detailed instructions.
- If you have any software firewalls, make sure they are not restricting the JamKazam application
- Enable uPnP on your router
- Enable NAT-PMP on your router (if supported by your router)
- Check your router's built-in security settings
- Ensure you are plugged into a network cable, and are not using wireless internet
After making any of these changes, be sure that you fully quit and restart the JamKazam application.
Checking firewall software:You may be running a software firewall, whether built-in to your operating system (i.e., Windows Firewall), or as an external application (i.e., McAfee, Norton, ZoneAlarm). To ensure these types of firewalls do not aggressively limit the JamKazam application, we recommend you add an exception to your firewall software for JamKazam. Some common instructions are linked below.
- Windows Firewall: [http://windows.microsoft.com]
- McAfee: [http://service.mcafee.com]
- Norton: [https://support.norton.com]
- Comodo: [http://help.comodo.com]
Checking your router settings:Before we begin, we recommend that you familiarize yourself with your router's admin interface, either by searching out your router's model number online, or by reading the manual which came with your router.
Typically, there will be an address you can type into your internet browser (generally, 192.168.1.1) that allows you to log in and update router settings. The default password will be found in your router's documentation.
Finally – due to the enormous number of router vendors and model numbers out there, the easiest way to find instructions on making any of these changes to your router may simply be to search the web:
“how do I <action> on a <router model> ?”
Enable uPnPAccess your router configuration and make sure uPnP is enabled. This will allow the JamKazam application to automatically open whatever ports are needed to stream with other musicians.
Enable NAT-PMPIf you have a supported router (Apple Airport, particularly), the first step you should take is to access your router configuration tool, and enable NAT-PMP. For instructions, please see this article provided by Apple or search your router's manual to determine if NAT-PMP is included.
Note: in the Apple article linked above, the default host is the IP address of the computer running JamKazam.
Check router security and firewall settingsNavigate through your router's admin tool and try to determine if your router has security settings. Many manufacturers (particularly routers provided by your ISP) will include built-in firewall settings to block entire port ranges. If there is a security setting on your router, try setting it one notch lower and see if the problem is resolved.
Disable QoSIf your router has a QoS feature, we recommend that it be disabled entirely, since it can play with your network traffic. This by itself won't necessarily cause you to fail the Network Test, but it can add jitter, and end up lowering the quality of your JamKazam sessions. Since you're in the router, go ahead and make sure it's off. Unless you have assigned your JamKazam computer “highest priority”, it won't do you any favors.
Finally, after making any of these changes, be sure that you fully quit and restart the JamKazam application, then retry the Network Test by clicking "Network Test" in the drop-down menu at the top-right corner of your client window.
If none of the above suggestions have resolved the issue, there is one more thing you can do. It is more complicated, but worth trying.
Setting up Port Forwarding:By default, JamKazam uses a number of dynamically chosen ports. You can pin down these ports down in JamKazam to be the same every time, which is important because then you can then configure your router to allow traffic in on these pinned ports. This requires you to set your router's Port Forwarding settings, a process which will be documented in the manual which came with your router.
These instructions will assume port numbers 12000-12010 as an example; feel free to use these ports because it is extremely unlikely you have any other applications configured to use the same ports on your router.
First, configure the JamKazam application to use port forwarding:
- Close JamKazam, by right-clicking the JamKazam systray icon, and selecting ‘Preferences’.
- This will bring up the Application Preferences dialog. There are two settings you need to make.
- CHECK Always use the same set of UDP Ports
- Use the default of 12000 in The first port that the client will open.
- When you are done, your dialog should look as shown just below:
- Click SAVE.
- You will be prompted to restart the application. Please do so.
Next, set up port forwarding on your router:
Find your router's Port Forwarding settings, and configure them to allow UDP traffic in to ports 12000-12010 to the IP address of the computer running JamKazam. This process varies from router to router so you may need to consult your router documentation.
If you continue to experience problems after making these recommended changes, please don't hesitate to reach out to our Support team so that we can help get you going.