Updating Moduliser App

This guide explains how to update the Moduliser application on a device that already has the OS image installed and configured.

Prerequisites

• SSH access to the Moduliser device
• The device must have network connectivity (Ethernet or Wi-Fi)
• GitHub Packages authentication must be configured (the .npmrc file with the auth token and registry scope is already set up on the OS image)

Default SSH credentials

Check current version

From the terminal:

moduliser --version

Or from within the application, press Ctrl+B to open the About panel — the current version is displayed there.

Update to the latest version

 npm install -g @omirion-labs/moduliser-cli

Update to a specific version

If you need a particular version (e.g. 0.12.1):

npm install -g @omirion-labs/moduliser-cli@0.12.1

Verify the update

moduliser --version

The output should reflect the new version number.

Rollback to a previous version

If the new version causes issues, install the previous version explicitly:

 npm install -g @omirion-labs/moduliser-cli@<previous-version>

Troubleshooting

Authentication error (401 / 403)

The .npmrc file at ~/.npmrc or /root/.npmrc must contain a valid GitHub Packages token:

//npm.pkg.github.com/:_authToken=ghp_XXXXXXXXXXXX
@omirion-labs:registry=https://npm.pkg.github.com

If the token has expired, contact the Moduliser administrator for a new one.

Network issues

Make sure the device can reach npm.pkg.github.com:

curl -I https://npm.pkg.github.com

If there is no connectivity, check that the Ethernet cable is connected or that the Wi-Fi is configured properly.