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-.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.9GB, 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-.tar.gz in the future. Next, download the latest 'woofq2-.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 script 'set-sandbox-path'. Open a terminal where it is, and run it: # ./set-sandbox-path ...it is important to run this script first, as it will confirm where the build is to take place. If you have already followed the above instructions, the script will detect "../sandbox" exists and will use that folder for the build. 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, in an SSD, 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. With EasyOS as the host, please do not do the build in a container. From the main desktop, mount a ext4 or btrfs partition and use that. Note also, the "devx" sfs is not required. The '1create-rootfs' script will offer to do an "offline" build. For now, please do not choose that, as Debian's APT package management system still requires you to be online, and may want to update some packages. 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 (that is on the to-do list). To update to a later version of woofQ2, you need to download the latest 'woofq2-.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