LIVE-REMASTER(1)

NAME
live-remaster - create a remastered live filesystem from the running live system

SYNOPSIS
live-remaster [options]

DESCRIPTION
live-remaster creates a new compressed live filesystem from the currently running live system. It is the main remastering tool in mx-remaster and is intended to be run from a live session, usually as root. The script copies the live system into a new squashfs image, updates the live metadata, and can refresh microcode in the resulting initrd files when supported by the installed tooling. It preserves the existing live-system workflow and uses the shared antiX common library for its interface, dialogs, and general option handling. The remaster can be run in a general mode, where personal data is excluded, or in a personal mode, where user settings are kept.

On a successful remaster (except in --pretend mode) it runs live-boot-refresh(1) to update the boot menu labels to the current release name. This step is non-fatal: a failure is logged but does not fail the remaster.

OPTIONS

-p, --pretend
    Build a smaller linuxfs.new image but do not delete it when the operation finishes.

-t TITLE, --title=TITLE
    Use TITLE instead of prompting for a title.

--general
    Create a general-purpose remaster. This mode excludes personal settings and user data.

--personal
    Create a personalized remaster. This mode keeps personal settings where possible.

--no-ucode[=LIST]
    Skip microcode refresh when rebuilding initrd images. The optional LIST may be amd, intel, or amd,intel. If no list is supplied, both vendors are skipped.

--version
    Print the program version and exit.

The script also honors the shared antiX common options provided by the underlying library, including the normal GUI/CLI and verbosity controls used by MX live tools.

FILES

/etc/live/version/linuxfs.ver
    Version metadata written by the remaster workflow and used by boot/menu tools.

/etc/live-kernel-updater/no-ucode-amd
    Vendor flag file that disables AMD microcode refresh.

/etc/live-kernel-updater/no-ucode-intel
    Vendor flag file that disables Intel microcode refresh.

/live/config
    Live configuration and state directory.

/live/boot-dev
    Boot device mount used by the remaster workflow.

SEE ALSO
installed-to-live(1), persist-makefs(1), live-grubsave(1), live-boot-refresh(1), mksquashfs(1)

AUTHOR
mx-remaster maintainers