Build EasyOS with woofQ2
------------------------

Create a folder for the woofQ2 project, in a Linux partition, 
ext4 or btrfs, and at least 20GB free space.

Please do the following as the 'root' user.

Let's give this folder a name, say 'build'.
Inside 'build', download woofq2-project-<date>.tar.gz 
(example: woofq2-project-250726.tar.gz), then expand:

# cd build
# tar -xf woofq2-project-250726.tar.gz
# sync

It will expand to folder 'woofq2-project'.

It is a big download, 2.5GB, but you only have to do it once. It contains all of
the Devuan/Debian Excalibur/Trixie packages so that woofQ2 can be built offline.

When you build EasyOS online, that package collection will update, hence you don't
need to perform that download of woofq2-project-<date>.ta.gz in the future.

Next, download the latest 'woofq2-<date>.tar.gz' and expand it inside 
folder 'woofq2-project' (example date 250726):

# cd woofq2-project
# tar -xf woofq2-250726.tar.gz

This will expand to folder 'woofq2'

Inside 'woofq2' you will find the build scripts:

# cd woofq2/rootfs

There are five scripts. Run them in sequence:

# ./1create-rootfs
# ./2create-devx-sfs
# ./3post-populate-rootfs
# ./4post-process-rootfs
# ./5create-drive-img

Do that the first time, to make sure they all work OK.
Future builds, you can run just this, it will run all 5 scripts:

# ./0build-all

On a reasonably fast modern computer, the total build takes about 35 minutes.

You will end up with a drive-image file, that can be written to a USB
drive, or you can do a direct install to an internal drive.

Note, EasyOS has "easyDD", which is a nice GUI wrapper for 'dd'.
It is in the menu, or you can run it in a terminal. With "-h" parameter,
It will print usage info:

# easydd -h

Usage notes
-----------

If the host OS is EasyOS Excalibur, all prerequisites for the build are installed.
On a different Linux OS, the '1create-rootfs' script checks for prerequisites.

A issue that does restrict what Linux distro host you can use; it must support
aufs. This is required in '2create-devx-sfs'
You could skip that script. It creates the "devx" squashfs file, an all-in-one
compile/develpment environment that can be loaded in a running EasyOS.
Better yet, modify it to use overlayfs.

To update to a later version of woofQ2, you need to download the latest
'woofq2-<date>.tar.gz. Delete the folder woofq2-project/woofq2
and expand the tarball.

This update method may seem crude, or very "old school", but has some advantages
over a git project.

Regards,
Barry Kauler
easyos.org
bkhome.org/news