Upgrading to Pi-Star V4

Revised: Jul 2019, CC BY-SA = open in new tab ]
Most up-to-date version: amateurradionotes.com/pi-star-upgrading-to-v4.htm Links: Standalone articles & PDFs

Note: This is an extract from the full Pi-Star notes article.

21) Upgrading to Pi-Star V4

If you're upgrading an existing hotspot from Pi-Star V3.#.## to Pi-Star V4 (or from Pi-Star 4.0 to 4.1): Due to the complexity of the OS upgrade, you can't just click the Upgrade link or run sudo pistar-upgrade. Fortunately, there's a shortcut that can make the upgrade easier: just back up your configuration running on the old version, copy the backup zip file to the root directory of a microSD card with the image of the new version, and boot up. I've tested this on Mac and Windows 10, and it works fairly well, requiring just a few additional configuration steps.

  1. Backup the Pi-Star configuration on your existing hotspot. For more info, see Backing up and restoring Pi-Star
  2. Download the Pi-Star V4 image:
  3. Insert a microSD card into your computer and flash a download of the Pi-Star V4 image to a microSD card. For more info, see Flashing Pi-Star
    Note: If using Windows, dismiss the system Format Disk message.
  4. After flashing the Pi-Star image to the microSD card, eject it, and then reinsert it.
    Note: If using Windows, once again dismiss the Format Disk message.
  5. Copy the backup zip file to the boot partition of the freshly imaged microSD card, and then eject it again.
  6. Insert the microSD card into the RPi and power it up. The first boot up will take a bit longer than usual because V4 now automatically expands the filesystem (sweet!) and then unpacks and restores your backed up configuration. The good news is that subsequent boot ups are even quicker than they were previously.
    - - - - - - - - - - - - - - -
    Hint (thanks to Larry, KF7L): If the image doesn't connect to your WiFi network and instead goes into Auto AP mode, the issue could be because your router doesn't broadcast SSIDs. In that case, try adding:
    to the /etc/wpa_supplicant/wpa_supplicant.conf file, between ssd and psk:
  7. Log into Pi-Star in order to open the Configuration page.
    • User Name – This your hotspot's hostname, either the default, pi-star, or whatever you changed it to in your backed up configuration.
    • Password – Even if you used your own Remote Access Password in the configuration you backed up, for security reasons, the Pi-Star backup does not back up this password, so you must use the default password to log in: raspberry.
  8. It's a good idea to double-check your configuration settings. Some settings are not backed up, so if you changed them to something other than the default, you'll find that they are back on the default settings of a new install, for example:
    • General Configuration:
      • System Time Zone (default Europe/London)
      • Dashboard language (default English_uk)
    • D-Star Configuration – Time Announcements (default: On) and Use DPlus for XRF (default: Off). If you change the Use DPlus for XRF setting, you must run a Pi-Star Update to put the new setting into effect.
    • Firewall Configuration – Auto AP (default: On)
    • Remote Access Password – Since Pi-Star backup does not back up this password, if you want to use your own password, which is a good idea, you'll need to enter your own password.
    • Expert Editor > CSS Tool – Custom CSS settings aren't backed up. If you change CSS settings, write them down so you can manually restore them.
    • SSH Public Key Authentication (PKA) – This is a bit of an edge case, but if you are using PKA to access Pi-Star via SSH, Pi-Star doesn't back up the custom settings (public key stored in an authorized_keys file in a custom folder named .ssh in the user's home directory). So if you do this (as an alternative to logging into Pi-Star via SSH using your Remote Access Password), you'll need to configure this again after booting up your fresh install.
  9. It's also a good idea to make a backup of your new Pi-Star V4 configuration. For more info, see Backing up and restoring Pi-Star.