man(8)

NAME
iso-snapshot-cli - create functional live snapshots from a Linux (antix or MX compatible) running system.

SYNOPSIS
iso-snapshot-cli [options]

DESCRIPTION
Program used for creating functional ISO images from the running system. You can later on install/burn the ISO image on a USB flashdrive or a DVD (depending on the size of the image). Use MX Live USB Maker (GUI) or live-usb-maker (CLI tool) to burn the resulting image. The tool has basically two different modes:
  - Preserving accounts (default) -- used for full backups and reinstallations. Takes a full image, includes user accounts and documents in /home folder (By default, to save space, it excludes ~/.VirtualBox folder).
  - Reset accounts -- for ISOs meant to be distributed to others. It doesn't save user account info, network settings, and doesn't save any files in /home folder. The resulting ISO is as close as possible to the official release with the difference that you can customize it by updating, installing, or removing programs and changing global settings (typically files in /etc/ folder).

WARNING
This tool is not actively tested on any other systems, it might or might not work, it might or might not break things. Basically, we don't recommend it for anything other than MX or antiX compatible systems.

OPTIONS

-h, --help
    Displays this help.

-v, --version
    Displays version information.

-d, --directory <path>
    Output directory

-f, --file <name>
    Output filename

-k, --kernel <ver, or path>
    Name a different kernel to use other than the default running kernel, use format returned by 'uname -r' Or the full path: /boot/vmlinuz-x.xx.x...

-l, --compression-level <"option">
    Compression level options. Use quotes: "-Xcompression-level <level>", or "-Xalgorithm <algorithm>", or "-Xhc", see mksquashfs man page

-m, --month
    Create a monthly snapshot, add 'Month' name in the ISO name, skip used space calculation This option sets reset-accounts and compression to defaults, arguments changing those items will be ignored

-n, --no-checksums
    Don't calculate checksums for resulting ISO file

-p, --preempt
    Option to fix issue with calculating checksums on preempt_rt kernels

-r, --reset
    Resetting accounts (for distribution to others)

-s, --checksums
    Calculate checksums for resulting ISO file

-o, --override-size
    Skip calculating free space to see if the resulting ISO will fit

-x, --exclude <one item>
    Exclude main folders, valid choices: Desktop, Documents, Downloads, Music, Networks, Pictures, Steam, Videos, VirtualBox. Use the option one time for each item you want to exclude

-z, --compression <format>
    Compression format, valid choices: lz4, lzo, gzip, xz, zstd

SEE ALSO
live-usb-maker -- writes created ISOs to USB flashdrives

AUTHOR
adrian@mxlinux.org