Installation and setup on Linux

Last modified by UT2UK on 2026/11/16 13:09

← EAX control user guide

Installing EAX on Linux

How to install EAX, create the virtual sound cards and make your first FT8 QSO. Fedora 38–44 and Ubuntu 20.04–24.04, about 15 minutes.

What you need

  • The ERMAK-TT transceiver is connected to the router and the EAX interface is enabled. You know its IP address.
  • A Linux computer on the same network.
  • The administrator password for sudo commands.
  • For digital modes — JTDX or WSJT-X installed.

Install EAX

Download the package for your system:

Open a terminal in the folder with the downloaded file and install the package:

Ubuntu

sudo apt install ./eaxcontrol-1.5.2-ubuntu24.04.deb

Fedora

sudo dnf install ./eaxcontrol-1.5.2-fc42.rpm

Check: EAX Control appears in the application menu.

Create the virtual sound cards

A virtual sound card is a “cable” inside the computer: EAX sends audio into it, and JTDX or WSJT-X receive it. On Linux the snd-aloop module creates such cards. You need two cards: no. 10 for receive and no. 11 for transmit.

Paste these three commands into the terminal. They configure the cards and enable them at once, no reboot needed:

echo "options snd-aloop enable=1,1 index=10,11 pcm_substreams=2,2" | sudo tee /etc/modprobe.d/snd-aloop.conf
echo "snd-aloop" | sudo tee /etc/modules-load.d/snd-aloop.conf
sudo modprobe snd-aloop

Check: aplay -l | grep Loopback shows 4 lines — cards 10 and 11, two devices each.

modprobe reports an error (Ubuntu)

On some Ubuntu versions the module is in a separate package. Install it and repeat the commands:

sudo apt install linux-modules-extra-$(uname -r)

On Fedora the module is already in the system.

Add names for digital mode programs

This command creates two devices with clear names — ERMAK_OUT and ERMAK_IN. You will select them in JTDX or WSJT-X.

cat >> ~/.asoundrc <<'EOF'
pcm.ERMAK_OUT {
    type plug
    slave { pcm "hw:10,0,0" format S16_LE rate 48000 channels 2 }
    hint { show on description "Ermak EAX VAC RX" }
}
pcm.ERMAK_IN {
    type plug
    slave { pcm "hw:11,1,0" format S16_LE rate 48000 channels 1 }
    hint { show on description "Ermak EAX VAC TX" }
}
EOF

Do not add pcm.!default lines from old guides to ~/.asoundrc. Today PipeWire or PulseAudio manages audio on Linux, and such lines can mute audio in other programs.

Set up EAX

Start EAX and click the settings button ic_settings.png. Select the devices as shown:

devmap_linux_en.png

05_settings_linux.png

  • EAX Output — Loopback: PCM (hw:10,1)
  • EAX Input — Loopback: PCM (hw:11,0)
  • Audio device — default: audio goes to the speakers selected in the system
  • Local IP address — the computer address on the same network as the transceiver

Local IP address is the most important field. The first three numbers must match the transceiver address: 192.168.1.50 → 192.168.1.10. On first start it shows 127.0.0.1 — with it there is no audio.

Click OK.

EAX reads the list of audio devices at startup. If the Loopback cards are not in the list, close EAX and start it again.

Connect to the transceiver

  1. In the URL field type the transceiver address and port 4002, for example 192.168.1.50:4002.
  2. Click ic_connect.png.

Check: Speed in the status line is above zero, the L and R meters move.

Speed is zero — open the port in the firewall

Fedora:

sudo firewall-cmd --permanent --add-port=16742/udp
sudo firewall-cmd --reload

Ubuntu (if ufw is enabled):

sudo ufw allow 16742/udp

Other causes — see Connected, but no audio.

Set up JTDX or WSJT-X

In the program select Input — ERMAK_OUT and Output — ERMAK_IN, and on the Radio tab — Hamlib NET rigctl with the transceiver address and port 4532. This is how correct JTDX and EAX settings look together:

eax_jtdx_linux.png

Details: JTDX and WSJT-X setup.

Check: JTDX shows decodes. You are ready for QSOs.

Summary of settings

ProgramFieldValue
EAXURLtransceiver IP address:4002
EAXEAX OutputLoopback: PCM (hw:10,1)
EAXEAX InputLoopback: PCM (hw:11,0)
EAXAudio devicedefault
EAXLocal IP addresscomputer IP address on the transceiver network
JTDX / WSJT-XInputERMAK_OUT
JTDX / WSJT-XOutputERMAK_IN
JTDX / WSJT-XRigHamlib NET rigctl, transceiver IP address:4532

Related articles