Posted on 25 Comments

Raspberry Pi – Update to WSJT-X 2.3.0

WSJT-X 2.3.0 introduces a new logging system that requires the installation of some additional packages. As a result, upgrading is not quite as simple as with previous versions.

Here’s a step by step guide.

  • Begin by updating the operating system (OS) with the following commands in a terminal session:
  • sudo apt update && sudo apt full-upgrade -y && reboot
  • This will update the OS and reboot the Pi
  • The WSJT-X logging requires use of the en_US.UTF-8 locale that’s not installed by default, so we need to add it as follows:
  • From a terminal session enter:
  • sudo dpkg-reconfigure locales
  • In the window that appears, scroll down to en_US.UTF-8 and press the spacebar to select it. You should see an asterix appear next to the selected locale.
  • Tab to OK and press Enter then press Enter again on the next screen. You will see messages that locales are being generated.
  • To make sure you have all the required packages installed, copy and paste the following into a terminal session:

sudo apt install libgfortran5 libqt5widgets5 libqt5network5 \
libqt5printsupport5 libqt5multimedia5-plugins libqt5serialport5 \
libqt5sql5-sqlite libfftw3-single3 libgomp1 libboost-all-dev \

  • That completes the preparation, so the next task is to download and install the new WSJT-X:
  • Open a browser and navigate to:
  • Scroll down to Installation Packages and select: wsjtx_2.3.0_armhf.deb
  • This will download the installation file to the Downloads folder
  • The final stage is to install the new version. This will install over your existing version, but keep all your settings:
  • sudo dpkg -i ~/Downloads/wsjtx_2.3.0_armhf.deb
  • When this completes, you can run WSJT-x as usual from the main menu.

Hopefully, this will give you a trouble-free update.

Mike – G4WNC

25 thoughts on “Raspberry Pi – Update to WSJT-X 2.3.0

  1. Mike
    I new to this site but I’m looking to run SpyServer with NESDR SMArT for a GOES Satellite system. I have all the hardware built and it is receiving signals from the Satellite. I’m not an IT person but I have work with the Raspberry PI software so I’m familiar with some the commands in Linux. My question is I see these updates for SpyServer Is there any new updated instructions that incorporate the changes so I can just follow them to build the Spyserver around the NESDR SMArt

    1. Hi Mike,

      Copy the code below into a script file named
      Make it executable by entering: sudo chmod + x
      Now run it with: ./
      That will download and install Spy Server and the RTL-SDR Drivers.

      Mike – G4WNC

      # This script installs Spy Server and RTL-SDR drivers

      cd ~

      echo "Downloading Spy Server ...


      echo "Unzip then delete the download

      tar xzf spyserver-arm32.tgz
      rm spyserver-arm32.tgz

      sudo chmod +x /home/pi/spyserver

      cd /home/pi

      echo "Now updating rtl-sdr drivers ...
      # -------------------------------------------------------------------------------------------
      cd /home/pi

      echo "Delete any old rtl-sdr downloads"

      sudo rm -rf /home/pi/rtl-sdr

      echo "Downloading rtl-sdr code from osmocom ..."

      git clone git://

      echo "Installing rtl-sdr ....."

      cd /home/pi/rtl-sdr
      mkdir -p /home/pi/rtl-sdr/build
      cd build
      cmake ../ -DINSTALL_UDEV_RULES=ON
      sudo make install
      sudo ldconfig

      echo "Remove the old blacklist and create a new one ..."

      sudo rm /etc/modprobe.d/blacklist-rtlsdr.conf

      sudo bash -c 'cat <> /etc/modprobe.d/blacklist-rtlsdr.conf
      blacklist dvb_usb_rtl28xxu
      blacklist rtl2832
      blacklist rtl2830

      # Tidy-up installation
      sudo rm -rf /home/pi/rtl-sdr
      sudo rm /home/pi/

      echo "

      Press return to exit ...
      read dummy

  2. Mike
    Thank you for the reply and the update. I loaded it last night and it work on the Raspberry PI. I was able to test the NESDR and it loaded it ok. I’m not sure I completely understanding how this all works. Could you give me a run down of how system is suppose to work? I started with your original instructions of May 25th of 2017 and updated it with the WSJTX and then updated it again with what you just provided me. So do I need to load something on a Windows PC to connect to the PI now? I think once I understand this then I will be able to continue on with the GOES satellite part of this.
    Thank you again for your help

    1. The script I provided does two things.1 – It installs the RTL-SDR drivers for communicationg with the dongle. 2 – It installs the Spy Server software. To run Spy server, open a terminal session and enter ./spyserver
      If you want Spy Server to start automatically when you boot the Pi, look at: “Running spy server as a service” in my blog
      To access your server from a PC you need to download and install the free SDR# from the Airspy website.
      When you have SDR# running, select SPy Server Network as the Source and enter the address of your Pi. For example if the Pi IP was you would enter the following:
      See how you get on and email me if you need help.

      1. Thanks Mike
        That makes it real clear. I work this and keep you posted.

  3. Mike
    I’ve downloaded the SDR# on the PC so that’s ready. I discover when I created the program on the PI using your original instructions I skip the last steps 4,5,6.7 and 8 and forgot to ask how to do that as I’m running headless and I can’t figure out how to get this done and over to the PI:
    “Select the SDR Server for 32bit ARM boards and download the file.
    Go to the download directory by typing: cd ~/Downloads
    Create a new directory for SpyServer by entering the following command: mkdir ~/spyserver
    Extract the downloaded tgz file using the following command: tar -xvzf spyserver-arm32.tgz -C ~/spyserver”
    I under the last few lines of this, its the first part.
    Then once I under stand how to do this I will make the new SD card.

  4. Mike
    update from my last Email. I’ve got the SDR Sever for 32bit Arm boards downloaded on the PI I can it in the download folder. I and have the directory Spyserver created. So I don’t quite understand your original instructions #8 about extracting the download TGZ file. Could you help me with this part? After I get through this part here, do you want to continue through update
    Raspberry Pi – Update to WSJT-X 2.3.0 or just use your script that you provided in the email date 25 Feb ?
    Thank you for helping though this.

  5. Mike
    I got the system running yesterday. I found for me the best way to do the install was to use Raspberry with desktop. This way I was able to load the two files I was having trouble with. I did use SSH in some parts I also was able to open a browser and download those files I was having trouble with ease. Then using the script you provided me everything came together.
    What does WSJT-X 2.3.0 do for the Airspy system? I load it anyway but wasn’t sure if it was needed.
    For me this was great learning experience for me using Linux.

  6. Mike
    Everything is working fine now. I want to have it autostart on boot up and stay running without having to be log in. Since I know there have been some changes is there a script I can use to have the PI SpyServer autostart?
    Thanks for your help

    1. Hi Mike,

      The best way is to run Spy Server as a service. the following post on my blog shows you how.
      Raspberry Pi – Running Spy Server as a service


      Mike – G4WNC

  7. Hi Mike
    Thank you so much that worked!

  8. Mike
    I got a new Windows 10 64 bit computer. I wanted to download the AirSpy for Windows to use with the Raspberry PI server. There seems to be a problem with the Windows 32 & 64 bit package on the download site. I’ve tried several different computers to download and it either won’t download or the computer says the package is infected. I’ve even tried it on the Windows 7 that previous download it on and its reporting the same thing.
    Is there an alternate method of downloading the package to make it work on a Windows computer that you might know of? I tried asking over on the AirSpy Group and the moderator won’t post my message.
    Thanks again

    1. Hi Mike,

      It’s the Software Defined Radio Package you want (first of the list) not Spy Server. When you run it for the first time, you will get a message saying that Windows protected your PC. Just click on the More Info link and choose Run anyway. This happens because the software isn’t digitally signed by Microsoft (that woulkd be just another excuse to extract money from us!).

      Mike – G4WNC

  9. Hi Mike
    I’ve found the PI 3b is to slow to enable the GOES Satellite Software from USA Satcom to run properly. So it was recommended that the ODROID-H2 would work better and better than the PI 4. If I decided to move to ODROID-H2 would SpyServer work and your scrips? I would guess there’s a different OS for ODROD also? Just trying to understand my options here.
    Thanks for your help again!

  10. Mike,
    I would like to get WSJT-X 2.4 running on my Pi 4.
    Should I follow your advise re loading 2.3 or are you by chance including 2.4 on you data modes package?
    Rod G3TXA

    1. Hi Rod,
      Apologies for the late reply. Yes, you can use the 2.4 instructions – just remember to change the version number to match the download.
      My SD cards are kept up to date and the Data Modes card uses WSJT-X 2.4


      Mike – G4WNC

  11. Hi Mike,

    I just purchased one of your data SD cards and the whole point of getting a pre-loaded card was to avoid having to download anything from the internet.
    In one of your last replys to a question, you commented that the new cards have WSJT-X 2.4 on them, will this new updated card i will be receiving allow me to simply load the card into the Pi without having to link to the internet?

    Rick Moskovits

    1. Hi Rick,

      Yes, the cards have all the software fully installed and ready to go. You just have to add your station details. You don’t need to download anything from the Internet.


      Mike – G4WNC

      1. thank you!

  12. Hello Mike,

    Thank you for the WSJTX upgrade details for the Raspberry Pi. Upgraded to v 2.4.0 as per your instructions. Much appreciated.

    1. Hi Ralph,

      Glad to hear you found it helpful. Mike

  13. Hi Mike,
    Trying to get Pi-4 with 7 inch screen to display WSJT-X v2.5.1 correctly. Have used the resize function but display still too wide and long.
    Please advise,

    1. Hi Russell,

      I’m afraid it’s bad news as WSJT-X won’t work with the Pi 7″ screen. This is because WSJT-X has been designed as a desktop application and requires a minimum screen resolution of 1024 x 780 pixels. Unfortunately, the Pi screen is only 800 x 480 pixels.

      Here’s an extract from the WSJT-X web site:

      WSJT-X minimum requirements:
      SSB transceiver and antenna.
      Computer running Windows (XP or later), Linux, or OS X.
      1.5 GHz or faster CPU and 200 MB of available memory. ( …
      Monitor with at least 1024 x 780 resolution.

      Sorry to disappoint,

      Mike – G4WNC

  14. sorry – some of my message lost !!
    Problem is with installing wsjtx on Pi 400.

    1. Hi David,

      I can’t think of anything different with the 400 that could cause a problem. Unfortunately, my Pi-400 is out on loan so I don’t have one to play with here. When you say it doesn’t work, can you be more precise?

      Mike – G4WNC

Leave a Reply

Your email address will not be published.

This site uses Akismet to reduce spam. Learn how your comment data is processed.