Installing

Mizu starts from a USB stick and can stay there. Installing it onto a disk is a choice you make later, from inside it.

What it needs

From a USB stick

  1. Download mizu-1.0-preview.img.zip from Releases and unzip it.
  2. Write the image to the stick with Rufus (DD image mode) or balenaEtcher. Everything on the stick is replaced.
  3. Start the PC from the stick: the boot menu key is usually F12, F11, F8 or Esc at power on.

The first start opens Mizu Setup: a language, the clock, your name, and if you like a password or a PIN. A minute later you are on the desktop, and everything you do is kept on the stick.

Onto a disk

Start > System Tools > Install Mizu...

  1. Choose the disk. The one Mizu is running from is never offered.
  2. Choose the whole disk, or only its free space. With free space, Windows or Linux on the disk stay as they are; Mizu creates its partitions in the space nobody uses. To make room, shrink the other system's partition with its own tools first.
  3. Say how many gigabytes Mizu gets, check the partition table before and after, and confirm.
  4. Click Restart with the stick still in. The computer's boot menu gets a "Mizu" entry by itself; from then on Mizu starts from the disk.

An existing EFI system partition is reused and never formatted: Mizu's loader goes in beside the others. If that partition is too small, Setup says so and stops.

In a virtual machine

VirtualBox

New machine, type Other, version Other/Unknown (64-bit), 2 GB of memory. In System, tick Enable EFI. Attach mizu-1.0-preview.vdi to the SATA controller.

QEMU

qemu-system-x86_64 -enable-kvm -m 2G -machine q35 -smp 4 \
  -drive if=pflash,format=raw,readonly=on,file=/usr/share/edk2/ovmf/OVMF_CODE.fd \
  -drive format=raw,file=mizu-1.0-preview.img \
  -device qemu-xhci -device usb-mouse -device usb-kbd \
  -device e1000e,netdev=n -netdev user,id=n -device intel-hda -device hda-output

How the disk is laid out

PartWhat is on it
EFI system partitionThe loader, and which system slot to start (FAT32).
Slots A and BThe system itself, a read-only SquashFS image, seen as Z:\MIZU. One runs, the other takes the next update.
DataYour files and settings, on KFS, as Z:. Never rolled back.

Using Mizu →