Setting up an OpenWebRX Receiver On A Rapberry PI

This is a basic tutorial to getting Openwebrx set up on a raspberry pi computer.

List of items you need:

  • Raspberry Pi 3 or better
  • USB Dongle such as RTL_SDR device
  • Suitable Antenna
  • Micro SD card at least 1GB
  • OpenWebRX raspberry pi image
  • Etcher software for writing to the SD card

Procedure:

  1. Download the Etcher software from here: https://www.balena.io/etcher/
  2. Download (and unzip) the OpenWebRX Raspberry Pi image from here: https://www.openwebrx.de/download/rpi.php
  3. Load your micro SD card into your windows laptop (that you downloaded the above software onto!)
  4. Open Etcher and click ‘Flash from file’ button then select the unzipped Pi image you downloaded, click ‘open’ (IGNORE ALL FORMATTING POPUPS – DO NOT FORMAT!
  5. Once image is loaded onto SD card, use file explorer to open the card, you should be able to view the ‘Boot’ folder
  6. Right click in this folder and create new text document, name it ‘ssh’, leave it empty
  7. Now load the micro SD card into your Raspberry Pi device, connect it to ethernet, plug in an RTL SDR dongle and boot up the Pi.
  8. Once booted up it should appear on your home network called ‘openwebrx’
  9. Make a note of its IP address
  10. Open a web browser window and type the noted IP address into it, you should be met with this screen (and a scrolling waterfall):

Create a User management account (via SSH):

  • Open a terminal window on your windows machine connected to the same network
  • type ‘ssh pi@192.168.1.83’ (use your assigned IP address here which may not be the same as mine)
  • type yes to accept
  • you should get the openwebrx prompt
  • type ‘sudo openwebrx admin adduser admin’
  • then type a password at the prompt
  • it should then have created your admin account
  • go back to your openwebrx sdr webpage, click ‘settings’ in the top right corner. Use the login details you just created to login
  • You can then setup your site information under ‘General settings’ etc
  • List of SSH admin commands here: https://github.com/jketterl/openwebrx/wiki/User-Management

Port Forwarding:

You’ll need to create a port forwarding rule on your home router in order to see the websdr outside of your network. The default port to use for this is 8073 along with your assigned IP address. Alternatively you can setup a DNS service (google!). If you use port forwarding you need to make sure you have a fixed home public IP address, otherwise if your IP changes, users will not be able to reach your websdr. A DNS service helps here too.

Feel free to try my Web SDR:

http://sdr.m7spi.co.uk