// docs

Construír a ISO

Toda a ISO sae dun só script, build.sh, que produce unha imaxe híbrida (BIOS + UEFI) lista para gravar nun USB.

Requisitos

Un Linux con root: Ubuntu 24.04 ou Debian 12. En Windows, usa WSL2 ou unha máquina virtual.
Conexión a Internet para descargar os paquetes.
Varios GB libres para o sistema de traballo (work/).

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

Construír

Desde o cartafol do SO:

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

Resultado en out/:

redderos-<base>-amd64.iso: a imaxe.
redderos-<base>-amd64.iso.sha256: o seu SHA-256.

Que fai o script

Sistema base. debootstrap crea un sistema mínimo (--variant=minbase) en work/rootfs. Se xa existe, reutilízase.
Overlay. Copia overlay/ sobre a raíz: devasa, Tor, sysctl, systemd e os scripts propios.
Chroot. hooks/chroot.sh instala o kernel, o sistema live e os paquetes de config/packages.list; configura o idioma e o teclado (español), o escritorio, os usuarios e os servizos, e rexenera o initramfs.
squashfs. Comprime a raíz con xz.
GRUB. Completa config/grub.cfg cos parámetros de endurecemento e xera as sumas md5sum.txt e sha256sum.txt de cada ficheiro.
ISO. grub-mkrescue crea a imaxe (etiqueta REDDEROS) e o seu SHA-256.

Variables

Variable	Predeterminado	Para que
`BASE`	`debian`	`debian` ou `ubuntu`.
`SUITE`	`bookworm` / `noble`	Versión da distribución base.
`MIRROR`	`deb.debian.org` / `archive.ubuntu.com`	Réplica de paquetes.
`KERNEL_PKG`	`linux-image-amd64` / `linux-image-virtual`	Paquete do kernel. Con Ubuntu, `linux-image-generic` para hardware real.
`WORK`	`./work`	Cartafol de traballo.
`ISO_NAME`	`redderos-<base>-amd64`	Nome da ISO, sen extensión.
`GRUB_DEFAULT`	`0`	Entrada de GRUB predeterminada (`3` = autotest).
`ISO_ONLY`	—	Con `1`, reutiliza a raíz xa configurada e só rexenera a imaxe.

Exemplos:

# 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

Personalizar

Paquetes: engade ou quita liñas en config/packages.list (as que comezan por # ignóranse).
Ficheiros do sistema: todo o que poñas en overlay/ cópiase tal cal sobre /.
Menú de arranque: config/grub.cfg. @LIVE@, @BOOT@ e @HARDEN@ substitúeos o script.
Perfís: o número de ocos e o custo de Argon2id están en overlay/etc/redderos/profiles.conf.

Gravar e probar

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

Antes de publicar unha ISO, pasa o autotest: consulta Autotest.