EPITA PIE VM

View on GitHub

epita-pie-vm

The PIE desktop: AFS login at first boot

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 in vm/pie-ova.nix.
  • Container image: ./pie setup. Needs nixos-pie:latest locally; ~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.

esc