Updating and upgrading Pi-Star

Updated: Sep 2018, CC BY-SA
Most up-to-date version of this note:
updates.hamnotes.com
PDF:  5-Pi-Star_updates.pdf
[ △ = open in new tab ]

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

8) Updating Pi-Star

Pi-Star update version
One of the nice things about Pi-Star is that it's updated on a regular basis to add new features, options, and fixes, as well as to add hostfile updates that have been pulled from upstream sources. There are three ways to update Pi-Star: one automated and two manual:

9) Upgrading Pi-Star

Pi-Star upgrade version
The less frequent Pi-Star version upgrades affect the base system services and packages. Both the update and upgrade processes automatically switch Pi-Star into Read-Write mode, so there's no need to switch manually.

  1. Use an app to SSH into Pi-Star and log in. Or you can use the Update and Upgrade links in the Expert Editor.
  2. Begin with an update of the dashboard and binaries.
    In the SSH window:
    sudo pistar-update
    Or, click the Expert Editor's Update link.
    Allow the update process to run until you see:
    Updates complete, sleeping for a few seconds before making the disk Read-Only
    Finished
  3. Next, upgrade the operating system, services, and packages.
    In the SSH window:
    sudo pistar-upgrade
    Or, click the Expert Editor's Upgrade link.
  4. Run the upgrade process as many times as needed until the system reports you are on the most recent version:
    You are already running the latest version…
    Sleeping a few seconds before making the disk Read-Only…
    Finished
  5. It's a good idea to reboot the hotspot after upgrading.
    In the SSH windows:
    sudo reboot
    Or, open the Power view, and then click Reboot.
  6. The dashboard displays the current version number, for example, 3.4.16.

For more info about what's included in an upgrade: On the Pi-Star Downloads page△, scroll down to the Change Log section.