Instructions about the files in this directory

1. Backup and restore

The file 'backup' must be run when booted live, and it will backup the content of the
partition for persistence.

./backup

It will create one tarball each time,

1-writable.tar.gz
2-writable.tar.gz
...

The file 'restore' must be run when booted live, and it will restore content of the
partition for persistence from the selected tarball.

./restore

2. Running a custom system live (live-only)

2.1 Modify the system by running a persistent live system,

install tools
tweak the appearance
...

2.2 Boot live, change directory to this one (usbdata) and run 'backup'

Now you have a tarball. Normally one tarball, '1-writable.tar.gz'.

2.3 If you wish, you can change the label of the partition for persistence to
something else than 'writable' or 'casper-rw', for example 'ext-data'. This will
make the drive live-only (until you change the label back again).

3. Make the live system into your custom system

You can run live or live + toRAM. And you can repeat this many times.

3.1 Boot live, change directory to this one (usbdata) and run 'extractor4live'

./extractor4live

It will extract what is stored in the tarball '1-writable.tar.gz' to the live system,

and write to the log files

error4live.log
list4live.log

I have seen the following errors, but do not know yet, if they cause problems.

tar: rofs: Cannot utime: Read-only file system - OK
tar: rofs: Cannot change ownership to uid 0, gid 0: Read-only file system - OK
tar: etc/xdg/autostart/gnome-software-service.desktop: Cannot mknod: Operation not permitted - OK
tar: etc/security/limits.d/audio.conf.disabled: Cannot mknod: Operation not permitted - ?
tar: Exiting with failure status due to previous errors - only 'summary'

Please check for errors and report bugs, that may be related to them.

3.2 Change directory to your home and enjoy :-)

cd

3.2 More than one custom live system

If you have two or more tarballs, you can make extractor files for each of them.

4. Start using your custom live system

When you shutdown or reboot, what you have done in the live system is forgotten,
except if you store things in the 'usbdata' partition or the 'ext-data' partition.
So normally you should change directory to your home and enjoy :-)

cd