Registering a new JackTrip Virtual Studio device involves entering the URL http://jacktrip.local into your favorite web browser.
This is the most common step to cause trouble, because it can fail for many different reasons. This page is intended to help you troubleshoot getting past this hurdle, as a supplement to the Getting Started Guide.
- Do you have another JackTrip Virtual Studio device plugged into the same network? When registering, the device must be the only one plugged into the network. After registering, it's OK to have multiple devices plugged in at the same time. Note: each device on the same network must be configured to use a different port number under audio device settings. (See: Managing Audio Devices)
- Did you plug your ethernet cable into your router before plugging in power? If not, your device may have had trouble obtaining an IP address (via DHCP) from your router.
- Wait until the device has been plugged in for at least a minute (otherwise it is possible to corrupt your MicroSD card)
- Unplug power to the device
- Wait a few seconds
- Ensure your ethernet cable is connected correctly
- Plug power back in for the device
- Do you see blinking LED lights on the device next to your ethernet cable? If not, your device is likely not plugged into a router, or your router is not powered on. You may also have a bad ethernet cable. After correcting, follow the steps in #1
- Try using a different computer or device. Some operating systems (MacOS, iOS, Windows 10) work better than others.
- Try using "http://jacktrip" instead of "http://jacktrip.local" (remove ".local")
- If you are able to figure out the IP address assigned to your device by your router, try using that instead "http://<IPADDRESS>" (e.g. "http://192.168.1.225")
- If you use multiple devices for your Internet connection (for example, if you have a separate modem and WiFi router or access points), try plugging into an Ethernet port on your other device.
- The device includes two micro HDMI ports that you can use to connect it to a monitor or television using an adapter such as this one. When it boots, it will print its IP address to the screen. Use this instead, as described in step #6.
- Instead of using a device connected on WiFi (wireless), try using a computer that is connected to the same router via ethernet. Sometimes WiFi routers create separate networks that block communications with the devices that are connected via Ethernet.
- We've discovered that some application installers on Windows 10 are known to also install outdated "Bonjour" software which conflicts with the operating system's built-in mDNS discovery services. If you are having trouble, trying opening "Add or remove programs" under "System Settings" and search for "Bonjour." Uninstalling this and rebooting your computer has been shown to help.
The 20200825 image can sometimes have trouble downloading updates at startup, which causes the http://jacktrip.local URL to redirect your browser to register on 20hz.io. Please follow the troubleshooting steps for Device Not Updating Firmware.
Every JackTrip Virtual Studio device has a unique identifier (the MAC address of its ethernet device) and API credentials that it generates when first plugged into power. Registering a Virtual Studio device associates it with your account so that you (and only you) are able to control it remotely using the web application.
To accomplish this, the device has a tiny (HTTP) web server listening on port 80 that responds to all requests with a redirect to the web applications' device registration page. It uses the Multicast DNS (mDNS) protocol to broadcast its IP address to the local network using the name "jacktrip.local".