epita-pie-vm

The real EPITA PIE desktop (i3, toolchains, AFS, your configs) at home, built from epita/nixpie.
Virtual machine
Download (Proton Drive):
epita-pie-virtualbox.ova or epita-pie-vmware.ova (~13 GB each),
plus SHA256SUMS.
sha256sum -c SHA256SUMS # Linux, macOS
Get-FileHash epita-pie-virtualbox.ova -Algorithm SHA256 # Windows (PowerShell)
Import (VirtualBox: File > Import Appliance; VMware: File > Open), boot.
Log in on the AFS window for your real EPITA files, or skip it for a
local session (user epita, no password, /home/epita persists).
Defaults: 6 GB RAM, 4 CPUs, NAT. Any network, no VPN.
Snapshot right after importing: that is your factory reset.
First boot: update afs (no root, safe to re-run):
curl -fsSL https://raw.githubusercontent.com/KazeTachinuu/epita-pie-vm/master/vm/hotfix.sh | sh
~/afs stuck or not reconnecting: afs off, then afs.
Windows: VirtualBox slow (green turtle)? Hyper-V is on; use VMware.
Docker container
The same desktop over VNC, no hypervisor. Needs docker and a VNC viewer
(macOS built in; elsewhere virt-viewer).
./pie pull # prebuilt image: ~13 GB download, ~30 GB on disk
./pie run # start + open the VNC viewer (AFS login window, or `afs`)
./pie reset # stop
pull needs PIE_IMAGE pointed at a registry ref. The image bundles
EPITA-proprietary software: EPITA's internal registry only, or hand it
over as a file (docker save | zstd / docker load).
Rebuild
- OVAs:
vm/build-ova.sh. x86_64 Linux, docker, ~150 GB free disk; the PIE store comes from EPITA's public nix cache. Any cloud VM works (no KVM needed); ~1 h on 16 cores. nixpie is pinned invm/pie-ova.nix. - Container image:
./pie setup. Needsnixos-pie:latestlocally; ~10 min.
Test afs
tests/afs-lab.sh fakes the EPITA gate locally (KDC + GSSAPI sshd);
tests/afs-test.sh replays the reconnect-the-next-day case in ~5 s.
Root, Ubuntu/Debian with /dev/fuse, or docker (see tests/afs-lab.sh).
tests/ova-check.sh dist/*.ova checks built OVAs without booting them:
manifest, baked afs = vm/afs, root-owned store.