Upgrade NiralOS EDGE

Overview #

NiralOS EDGE includes a Smart Interactive Installer that automatically detects existing installations and checks for newer product releases.

To upgrade your deployment, simply run the same installation command used during the initial installation. If a newer version is available, the installer will guide you through the upgrade process.

Important

An active Internet connection is required during the upgrade to download the latest NiralOS EDGE release.

Supported Operating Systems #

• Windows 
• Linux 
• macOS

Before You Begin #

Before starting the upgrade, ensure:

• Docker Engine is running. 
• The system has Internet connectivity. 
• Sufficient disk space is available for downloading the updated release. 

Note

During the upgrade, the application experiences a minimal service interruption while the existing services are replaced.

Step 1. Run the Installer #

Use the same installation command that was originally used.

Linux / macOS

curl -fsSL https://niraledge.com/install.sh | bash

Windows

irm https://niraledge.com/install.ps1 | iex

Step 2. Existing Installation Detected #

The Smart Installer scans the system for an existing installation.

If NiralOS EDGE is already installed, the installer displays available actions.

Example

Existing NiralOS EDGE installation detected.

Please choose one of the following options:

1. Upgrade Installation

2. Uninstall Installation

3. Exit

Select: 1. Upgrade Installation

Step 3. Version Check #

The installer compares the installed version with the latest available release.

If a newer version is available, a message similar to the following is displayed:

A newer version of NiralOS EDGE is available.

Would you like to upgrade?

Yes / No

Enter: Yes

to begin the upgrade.

If the installed version is already the latest version, the installer will notify you and no further action is required.

Step 4. Upgrade Process #

During the upgrade, the installer automatically performs the following actions:

1. Verifies the current installation. 
2. Downloads the latest release from the update server. 
3. Stops the currently running NiralOS EDGE services. 
4. Removes the existing application services. 
5. Preserves application data stored in Docker volumes. 
6. Downloads the updated application images and binaries. 
7. Creates the updated services. 
8. Starts the new version of NiralOS EDGE. 
9. Verifies that all services are healthy. 

Progress is displayed in the terminal throughout the process.

Step 5. Upgrade Complete #

After all services have started successfully, the installer displays a confirmation message.

Example

NiralOS EDGE has been successfully upgraded.

Dashboard URL: https://<MANAGEMENT_IP>

Your existing users, tenants, sites, environments, and application data remain available after the upgrade.

Upgrade Downtime #

During the upgrade process, NiralOS EDGE experiences a brief service interruption while the existing services are replaced.

The duration depends on:

• Internet download speed 
• System performance 
• Size of the software update 

Once the new services have started successfully, the dashboard becomes available again.

After the Upgrade #

After the installer completes:

1. Open a web browser. 
2. Navigate to: https://<MANAGEMENT_IP>
3. Log in using your existing credentials. 
4. Verify that all previously configured tenants, sites, and environments are available. 

No additional configuration is required after a successful upgrade.

Troubleshooting #

No Upgrade Available #

If the installer reports that no update is available, your installation is already running the latest released version.

Upgrade Cannot Download the Latest Release #

Verify:

• The system has Internet connectivity. 
• The update server is reachable. 
• Firewall or proxy settings are not blocking outbound connections.

Upgrade Interrupted #

If the upgrade is interrupted unexpectedly:

1. Ensure Docker Engine is running. 
2. Restore Internet connectivity if it was lost. 
3. Run the installer again using the same installation command. 

The Smart Installer will detect the existing installation and resume the upgrade process where applicable.