MVP OS 1.1 - build steps (Windows / Mac PC, x86_64, amd64 ISO) ============================================================= You run the whole build on your own PC. The ISO target is amd64 (x86_64), the same architecture as your PC, so it is a native build - no second machine and no cross toolchain. You need a Linux environment to run it in (see STEP 0), ~15 GB free disk, 2 GB RAM, and an internet connection. STEP 0 - get a Linux host (you need this to run the build) --------------------------------------------------------- Windows (WSL2 + Ubuntu - free, native speed): wsl --install -d Ubuntu # reboot when prompted, set a username/password, then you are in Ubuntu Mac (Ubuntu VM in UTM - free): 1. Install UTM from https://mac.getutm.app 2. Download the Ubuntu 24.04 desktop ISO (amd64) from ubuntu.com/download 3. UTM -> New VM -> Virtualize -> Linux -> Boot ISO = the Ubuntu ISO Architecture: x86_64, install Ubuntu into the VM, then open a terminal You are now inside a real Linux shell. The rest runs there. STEP 1 - install host build tools (inside the Linux host) ---------------------------------------------------------- sudo apt update sudo apt install -y debootstrap squashfs-tools xorriso grub-pc-bin \ grub-efi-amd64-bin grub-common dosfstools libarchive-tools curl mtools \ qemu-system-x86 ovmf (Arch Linux host instead: sudo pacman -S debootstrap squashfs-tools xorriso \ grub dosfstools libarchive curl arch-install-scripts mtools ovmf qemu-desktop) STEP 2 - get the build script ---------------------------------------------------------- curl -fLO https://id-preview--e903ccdb-d247-4524-ad40-4a3522227643.lovable.app/mvpos/build-mvpos.sh chmod +x build-mvpos.sh STEP 3 - build the ISO (60-90 min, downloads ~1 GB) ---------------------------------------------------------- sudo ./build-mvpos.sh # core system -> mvpos-1.1-amd64.iso sudo TOOLS=full ./build-mvpos.sh # + nmap, tcpdump, kali-linux-core sudo USERNAME=me USERPASS=secret ./build-mvpos.sh # custom credentials Result: ./mvpos-1.1-amd64.iso STEP 4 - boot it ---------------------------------------------------------- Windows / any Linux x86_64 host (QEMU + OVMF, UEFI): qemu-system-x86_64 -M q35 -m 2048 \ -bios /usr/share/OVMF/OVMF_CODE.fd \ -cdrom mvpos-1.1-amd64.iso -nic user,model=virtio-net-pci Mac (UTM): New VM -> Virtualize -> Linux -> Boot ISO = mvpos-1.1-amd64.iso Architecture: x86_64, UEFI Boot: ON, Network: Shared (gives DHCP) STEP 5 - verify it is a real OS ---------------------------------------------------------- uname -a # real kernel ps -p 1 -o comm= # systemd = real PID 1 init id # real uid/gid sudo -i # real privilege escalation (password: kali) ip a # real interface, DHCP lease ping -c3 1.1.1.1 # real network stack apt update && apt install -y cowsay # real package manager busybox --list | head # BusyBox utilities present WHAT IS IN IT bootloader : GRUB 2 (UEFI, x86_64-efi, El Torito EFI image on the ISO) kernel : Debian/Kali linux-image-amd64 init : systemd (PID 1) + live-boot initramfs shell : bash + BusyBox + coreutils, autologin on tty1 privileges : real users, /etc/shadow, sudo via /etc/sudoers.d/10-mvpos network : NetworkManager + systemd-networkd DHCP, iproute2, ping, dig, curl packages : apt against the Kali rolling mirror - install anything later NOTES / TROUBLESHOOTING * "E: Release signed by unknown key" -> the script fetches and extracts the kali-archive-keyring itself; if the mirror is blocked, set MIRROR=http://kali.download/kali * "qemu: could not load OVMF bios" -> install OVMF: Debian/Ubuntu: sudo apt install -y ovmf Arch: sudo pacman -S ovmf then point -bios at /usr/share/OVMF/OVMF_CODE.fd (Ubuntu) or /usr/share/edk2-ovmf/x64/OVMF_CODE.fd (Arch). * Blank screen after GRUB -> pick the "verbose / rescue shell" menu entry, it forces console=tty0 output. * Want persistence -> add a second disk, then inside the live system: sudo apt install -y calamares-settings-debian (or debootstrap onto /dev/vdb) * Want an arm64 ISO instead (e.g. for an iPad/UTM aarch64 VM) -> build it on an aarch64 host: sudo ARCH=arm64 ./build-mvpos.sh