Troubleshooting
Failed to execute the [velocity] macro. Cause: [The execution of the [velocity] script macro is not allowed in [xwiki:Main.ERMAK-TT.Руководство пользователя EAX control.Решение проблем.WebHome]. Check the rights of its last author or the parameters if it's rendered from another script.]. Click on this message for details.
Troubleshooting
Find what you see and open the fix. Also here: the router, choosing the IP address and operating from a remote QTH.
Find the fix in 2 questions
What does EAX show after you click the connect button?
EAX is fine. What about the digital mode program?
What do you see?
The message “Unable connect to remote Rig”.
Speed is 0. A few seconds later — “Lost connection with Rig”.
Clicks, gurgling, gaps.
JTDX sees no signal or the transceiver does not transmit
Everything works in EAX, but not in the digital mode program.
The message “Unable to configure audio card”.
I need to operate from a remote QTH
The rig is at the home QTH, you are at the cottage or on holiday.
“Application is already running”, white window and others.
EAX does not connect
Wrong address
Check the URL field. You need the transceiver IP address, a colon and port 4002. Example: 192.168.1.50:4002.
The computer does not see the transceiver on the network
- Make sure the transceiver is on and connected to the router.
- Check the connection with ping (see below).
- If there are no replies, the problem is in the network or router. See Router.
The EAX interface is disabled on the transceiver
Enable EAX in the transceiver remote connection settings.
Connected, but no audio
The connect button is lit, but Speed is zero. EAX has reached the transceiver, but the audio from the transceiver does not get to the computer.
Cause 1. Wrong IP address in EAX settings
This is the most common problem, especially on Windows. When connecting, EAX tells the transceiver the computer address from the Local IP address field. The transceiver sends audio only to that address.
A computer often has several addresses: Ethernet, Wi-Fi, VPN, virtual adapters. If the wrong one is selected, the audio goes nowhere.

- Disconnect from the transceiver.
- Open EAX settings
. - In the Local IP address field select the address whose first three numbers match the transceiver address.
- Click OK and connect again.
Check: Speed is above zero, the L and R meters move.
On first start the field shows 127.0.0.1 — audio does not work with it. A laptop that connects sometimes over Wi-Fi and sometimes by cable gets different addresses — check the field after changing the connection.
Check the IP address for EAX
Cause 2. A firewall blocks the audio
The audio arrives at the computer over UDP on port 16742. A firewall may block it.
Windows:
- On the first connection Windows asks about network access. Click Allow access and tick Private networks.
- If you clicked Cancel: Control Panel → Windows Defender Firewall → Allow an app through firewall. Find eax and tick Private.
- Your network type must be Private, not Public: Settings → Network & Internet → network properties.
- If your antivirus has its own firewall (Kaspersky, ESET and others), allow EAX there too.
Cause 3. A VPN is on
Some VPNs send all traffic into the tunnel, and the home network becomes unreachable. Turn off the VPN or allow local network access in it (Allow LAN).
Router

Guest network. Devices on the guest Wi-Fi network do not see the main network. Connect the computer and the transceiver to the main network.
Client isolation (AP Isolation, Client Isolation). This Wi-Fi option stops devices from talking to each other. Turn it off in the router settings.
Two networks: regular and 5G (for example “Home” and “Home_5G”). Usually this is one network and EAX works. If there is no connection, put both devices on the network with the same name.
A mesh system or Wi-Fi extender sometimes creates a separate network. Check that the first three numbers of the transceiver and computer addresses match.
The audio drops out
Audio flows over the network continuously, and weak Wi-Fi breaks it up.
- If possible, connect the computer or the transceiver by cable.
- Increase RX buffer in EAX settings: x4 or x8.
- Close programs that load the network heavily (downloads, video).
JTDX sees no signal or the transceiver does not transmit
If the L and R meters move in EAX but JTDX sees no signal, the wrong input is selected in JTDX. If the transceiver goes to transmit but the M meter in EAX does not move, the wrong output is selected.
Correct devices: JTDX and WSJT-X setup.
If the transceiver goes to transmit but there is no power, select the EAX source on the transceiver in the TX settings window.
Sound card error
The message “Unable to configure audio card” means that EAX cannot open an audio device.
- In EAX settings select all three devices: EAX Output, EAX Input and Audio device.
- Close programs that may use these devices.
- Linux: check that the virtual cards are present — aplay -l must show Loopback lines.
- Close EAX and start it again.
Operating from a remote QTH
The transceiver is at your home QTH, and you are at the cottage, on holiday or at work. There are two ways to connect EAX to the transceiver over the Internet.

Option 1. Port forwarding
Works if both the home and the remote Internet have a public (external) IP address. Only router settings are needed.
Option 2. VPN
Always works, also without a public IP: mobile Internet, hotel, provider with CGNAT. Safer: no ports are open to the whole Internet.
Option 1. Port forwarding
On the home QTH router (where the transceiver is) forward to the transceiver IP address:
| Port | Protocol | Purpose |
|---|---|---|
| 4002 | TCP | EAX connection to the transceiver |
| 1277 | UDP | transmit audio from the computer |
On the remote QTH router (where the computer is) forward to the computer IP address:
| Port | Protocol | Purpose |
|---|---|---|
| 16742 | UDP | receive audio from the transceiver (Local UDP port field in EAX) |
In EAX:
- In the URL field type the public IP address of the home router and port 4002, for example 203.0.113.10:4002.
- Open settings. In the Local IP address field type manually the public IP address of the remote router. The transceiver will send audio exactly there.
- Click OK and connect.
Check: Speed is above zero. If the first number is 0, the UDP 16742 forwarding on the remote router does not work or the wrong address is in Local IP address.
An open port 4002 is visible to the whole Internet: anyone who knows the address can connect to the transceiver. If the router can do it, allow forwarding only from your remote QTH address. Or enable forwarding only while you operate.
Option 2. VPN
A VPN connects the computer to the home network as if you were in your shack. WireGuard, OpenVPN, ZeroTier, Tailscale or a VPN server built into the router will do.
- Connect the computer to the home QTH VPN.
- In the URL field enter the transceiver address on the home network, for example 192.168.1.50:4002.
- In the Local IP address field select the address of the computer VPN adapter.
No port forwarding is needed.
Other messages
Application is already running. EAX is already running. On Windows look for the EAX icon next to the clock.
Lost connection with Rig. No audio has arrived from the transceiver for a few seconds. See Connected, but no audio.
Reconnecting in N s... The connection dropped, EAX reconnects by itself. If this happens often, check the network.
White window on Windows. Install the OpenCL, OpenGL and Vulkan Compatibility Pack.
Nothing helped
- Close EAX.
- Start EAX with a log: Windows — eax.exe -L debug -l eax.log in the program folder, Linux — eax -L debug -l ~/eax.log.
- Reproduce the problem.
- Send the log file to the developers with a description: what you did and what you saw.