Updating AsteroidOS: Difference between revisions

From AsteroidOS
(Add the updating page from the current wiki)
 
(Rework code tags)
 
Line 14: Line 14:
The standard commands to upgrade are:
The standard commands to upgrade are:
<pre>
<pre>
opkg update
opkg update && opkg upgrade
opkg upgrade
</pre>
</pre>


== Troubleshooting ==
== Troubleshooting ==
* SSL certficate errors
* SSL certficate errors
: If you get messages like these, it's most likely because the time or date (or both) are not set correctly.
: If you get SSL error messages like the one below, it's most likely because the time or date (or both) are not set correctly.
<pre>
<code>
Downloading https://release.asteroidos.org/nightlies/ipk/all/Packages.gz.
Downloading https://release.asteroidos.org/nightlies/ipk/all/Packages.gz.</code>
* opkg_validate_cached_file: Failed to download https://release.asteroidos.org/nightlies/ipk/all/Packages.gz headers: SSL peer certificate or SSH remote key was not OK.
<code> * opkg_validate_cached_file: Failed to download https://release.asteroidos.org/nightlies/ipk/all/Packages.gz headers: SSL peer certificate or SSH remote key was not OK.
</pre>
</code>


= Reflash AsteroidOS =
= Reflash AsteroidOS =
If no IP connection can be established on your watch, the easiest way to upgrade is to reflash the entire operating system following the usual [https://asteroidos.org/watches/ installation instructions]. Make sure you select AsteroidOS in the Prerequisites checkbox to see the appropriate instructions.
If no IP connection can be established on your watch, the easiest way to upgrade is to reflash the entire operating system following the usual [https://asteroidos.org/watches/ installation instructions]. Make sure you select AsteroidOS in the Prerequisites checkbox to see the appropriate instructions.

Latest revision as of 13:55, 3 July 2023


As currently no AsteroidOS watch has access to the internet by stock means, no GUI for OTA upgrades is offered. This page documents upgrading AsteroidOS.

Upgrade using OPKG

Set the correct time and date on the watch. AsteroidOS needs to validate the remote server's certificate and establish a secure connection.

If you don't want to lose your personal data, and prefer upgrading Asteroid without reflashing it, you have two options to establish an internet connection from the watch.

In case your watch supports WLAN, connect it to your local Wi-Fi network using connmanctl as described on the IP Connection page. Alternatively you can share your internet connection from a PC to the watch via USB.

Once your watch can connect to the internet, you can use AsteroidOS' package manager: opkg

The standard commands to upgrade are:

opkg update && opkg upgrade

Troubleshooting

  • SSL certficate errors
If you get SSL error messages like the one below, it's most likely because the time or date (or both) are not set correctly.

Downloading https://release.asteroidos.org/nightlies/ipk/all/Packages.gz. * opkg_validate_cached_file: Failed to download https://release.asteroidos.org/nightlies/ipk/all/Packages.gz headers: SSL peer certificate or SSH remote key was not OK.

Reflash AsteroidOS

If no IP connection can be established on your watch, the easiest way to upgrade is to reflash the entire operating system following the usual installation instructions. Make sure you select AsteroidOS in the Prerequisites checkbox to see the appropriate instructions.