Upgrade instructions

Upgrading Web Radio Control software to a newer version is a simple procedure, because you can back up the existing configuration file, the TLS certificate and all other data saved in Web Radio Control and start using them in the new version.

In order to proceed with the upgrade procedure, you will need to have access to the Web Radio Control server computer (Raspberry Pi) and its power supply. A new version of Web Radio Control will need to be installed on an SD card by either overwriting the previous version or by using a new SD card, so that you can keep the old version as a backup.

It is important to go through steps 1-4, which instruct you to back up the old configuration file, the saved user data and the TLS certificate, because otherwise you will lose the existing settings and data saved in Web Radio Control!

  1. Open a web browser and navigate to the address of your Web Radio Control instance (https://DOMAIN-NAME:8012/)

  2. Back up the existing configuration file by downloading it from Settings > Backup/Restore > Export configuration file

  3. Back up the existing TLS certificate by downloading it from Settings > Backup/Restore > Export TLS certificate files

  4. Back up the saved user data (e.g. saved frequencies) file by downloading it from Settings > Backup/Restore > Export saved user data

  5. Shut down the Web Radio Control server computer (Raspberry Pi) by clicking Settings > Services > Shut down system, wait for about 2 minutes, cut off power from the computer and remove the SD card

  6. Download the new Web Radio Control image file on another computer and write it to a new or the old SD card (depending on your choice) according to the installation instructions

  7. Insert the SD card with the new Web Radio Control version into the Web Radio Control server computer (Raspberry Pi), turn on the power and wait for about 5 minutes until the SD card activity light (the green LED in Raspberry Pi) turns off and you can access the setup user interface in address http://webradiocontrol.local:8013 (please note the protocol http and the port number)

  8. Open a web browser and navigate to the address http://webradiocontrol.local:8013 (please note the protocol http and the port number)

  9. When the setup user interface asks for password, enter the default password: web-radio-control-change-me! (the exclamation mark is part of the password)

  10. Restore the old TLS certificate in section Import an existing TLS certificate from a ZIP file

    • Click Select certificate ZIP file…​ button and choose the ZIP file you used to back up the certificate

    • Click the Import button and wait until the certificate is imported and the green icon indicates success

  11. Restore the old configuration in section Import configuration

    • Click the Select file…​ button and choose the old configuration file with name ending in .yaml that you backed up

    • Click the Import button and wait until the configuration is imported and the green icon indicates success

  12. Click the Restart button to make Web Radio Control use the backed up configuration and TLS certificate

    • The restart procedure takes a short while, usually under a minute — the Web Radio Control server is inaccessible for this time

  13. Use a web browser to navigate to https://DOMAIN-NAME:8012 (please note the protocol https and port number 8012), where DOMAIN-NAME is the public domain name defined in your Web Radio Control configuration

    • If the remote control user interface displays error messages or you notice any new features missing, the web browser may still be using an old version of the user interface from the web browser cache. In this case, clear the web browser cache and reload the page.

  14. Restore the old saved user data by in Settings > Backup/Restore > Import saved user data

    • Click the Select file…​ button in section Import saved user data and choose the old saved user data file with name ending in .json that you backed up

    • Click the Import button and wait until the user data is imported and the green icon indicates success

The upgrade is now finished!