Skip to main content

Nitrux Update Tool System

Estimated reading: 1 minute 72 views

NUTS is the update and rollback utility for Nitrux. It performs atomic system updates while preserving the ability to restore the previous state.

How it Works

  1. Creates a backup of the root partition using xfsdump.
  2. Downloads an OTA-style archive and applies the update atomically.
  3. Rollbacks are performed offline from a Live session using xfsrestore.

NUTS operates on the root filesystem as a whole rather than managing individual packages. It has no package index, cache, or dependency resolution—it replaces the immutable root with a new version.

Commands

Commands                    Description

sudo nuts update            Updates the root and creates a backup
sudo nuts rescue            Restores the backup (Live session only)
sudo nuts self-update       Updates NUTS itself

Options

Flag                        Description

-h, --help                  Show help
-v, --version               Show version
-d, --debug                 Enable verbose output
--use-main-branch           Use the main branch for components
--use-development-branch    Use the development branch for components

Configuration

NUTS reads settings from /etc/nuts.conf.

Information

For a detailed tutorial on the update process, see Resources → Tutorials → System.