// docs

Construir la ISO

Tota la ISO surt d'un sol script, build.sh, que produeix una imatge híbrida (BIOS + UEFI) a punt per gravar en un USB.

Requisits

Un Linux amb root: Ubuntu 24.04 o Debian 12. A Windows, utilitza WSL2 o una màquina virtual.
Connexió a Internet per baixar els paquets.
Diversos GB lliures per al sistema de treball (work/).

sudo apt install debootstrap squashfs-tools xorriso grub-pc-bin grub-efi-amd64-bin mtools

Construir

Des de la carpeta del SO:

sudo ./build.sh                 # base Debian bookworm (por defecto)
sudo BASE=ubuntu ./build.sh     # base Ubuntu noble (la que se ha probado)

Resultat a out/:

redderos-<base>-amd64.iso: la imatge.
redderos-<base>-amd64.iso.sha256: el seu SHA-256.

Què fa l'script

Sistema base. debootstrap crea un sistema mínim (--variant=minbase) a work/rootfs. Si ja existeix, es reutilitza.
Overlay. Copia overlay/ sobre l'arrel: tallafoc, Tor, sysctl, systemd i els scripts propis.
Chroot. hooks/chroot.sh instal·la el nucli, el sistema live i els paquets de config/packages.list; configura la llengua i el teclat (espanyol), l'escriptori, els usuaris i els serveis, i regenera l'initramfs.
squashfs. Comprimeix l'arrel amb xz.
GRUB. Omple config/grub.cfg amb els paràmetres d'enfortiment i genera les sumes md5sum.txt i sha256sum.txt de cada fitxer.
ISO. grub-mkrescue crea la imatge (etiqueta REDDEROS) i el seu SHA-256.

Variables

Variable	Per defecte	Per a què
`BASE`	`debian`	`debian` o `ubuntu`.
`SUITE`	`bookworm` / `noble`	Versió de la distribució base.
`MIRROR`	`deb.debian.org` / `archive.ubuntu.com`	Rèplica de paquets.
`KERNEL_PKG`	`linux-image-amd64` / `linux-image-virtual`	Paquet del nucli. Amb Ubuntu, `linux-image-generic` per a maquinari real.
`WORK`	`./work`	Carpeta de treball.
`ISO_NAME`	`redderos-<base>-amd64`	Nom de la ISO, sense extensió.
`GRUB_DEFAULT`	`0`	Entrada de GRUB per defecte (`3` = autotest).
`ISO_ONLY`	—	Amb `1`, reutilitza l'arrel ja configurada i només regenera la imatge.

Exemples:

# Ubuntu con drivers de hardware real
sudo BASE=ubuntu KERNEL_PKG=linux-image-generic ./build.sh

# Regenerar solo la imagen tras cambiar grub.cfg
sudo BASE=ubuntu ISO_ONLY=1 ./build.sh

Personalitzar

Paquets: afegeix o treu línies a config/packages.list (les que comencen per # s'ignoren).
Fitxers del sistema: tot el que posis a overlay/ es copia tal qual sobre /.
Menú d'arrencada: config/grub.cfg. @LIVE@, @BOOT@ i @HARDEN@ els substitueix l'script.
Perfils: el nombre de ranures i el cost d'Argon2id són a overlay/etc/redderos/profiles.conf.

Gravar i provar

sudo dd if=out/redderos-ubuntu-amd64.iso of=/dev/sdX bs=4M status=progress conv=fsync
qemu-system-x86_64 -m 3G -enable-kvm -cdrom out/redderos-ubuntu-amd64.iso

Abans de publicar una ISO, passa l'autotest: vegeu Autotest.