Daphnis 0.1.0
First run
You can run Daphnis two ways: in a window with QEMU, or on a PC started from a USB drive. Both use the same disk image, and QEMU is the place to start, with no USB drive to write and no firmware setting to change.
Requirements
Each way needs different things, listed below. Start with QEMU, because it needs no USB drive and no change to your PC's firmware.
In a window with QEMU, the way to start:
- A Linux PC with QEMU and its UEFI firmware. The steps below use Ubuntu 24.04.
- Memory: 4 GB for the window, given by the start command.
On a PC from a USB drive:
- An x86-64 PC with UEFI. Secure Boot off.
- A processor with RDRAND. Passwords are salted from it; without it no account can be made.
- Memory: 4 GB minimum, 8 GB recommended. The desk itself needs 512 MiB.
- A USB drive of 1 GB or more. The unpacked image is 606 MB. Writing the image erases the drive.
- A keyboard on PS/2, or a USB keyboard on one of the computer's own ports.
To build the image from source:
- Debian or Ubuntu. The image's build takes GRUB and the name of its source package from the system's package records.
Booted so far on an MSI MPG Z390 Gaming Edge AC (Core i7-8700K) and an HP Laptop 15-da0xxx (Core i5-8250U).
Download and check the image
Download the compressed image and SHA256SUMS from the release page, and put both in one folder. Open a terminal in that folder and run the two commands below: the first unpacks the image beside the download, and the second checks both files. The check shows the files arrived complete and unchanged, as long as SHA256SUMS came from the same release page; nothing is signed, so it shows no more than that.
xz -dk daphnis-0.1.0-x86_64.img.xz sha256sum -c SHA256SUMS
Each line it prints must read OK; if one does not, download the files again.
Run it in a window with QEMU
QEMU is a virtual machine: a program that runs a second computer inside your own, so Daphnis opens in a window beside your other programs. It is the one virtual machine Daphnis is tested on. These steps are for a Linux PC with QEMU and its UEFI firmware.
- Install QEMU and its UEFI firmware. On Ubuntu 24.04 the packages are qemu-system-x86 and ovmf.
sudo apt install qemu-system-x86 ovmf
- In the folder that holds the unpacked image, copy the firmware's settings file once, then start Daphnis with the command after it.
cp /usr/share/OVMF/OVMF_VARS_4M.fd daphnis-vars.fd qemu-system-x86_64 -accel tcg -cpu max -m 4G \ -drive if=pflash,format=raw,readonly=on,file=/usr/share/OVMF/OVMF_CODE_4M.fd \ -drive if=pflash,format=raw,file=daphnis-vars.fd \ -vga none -device bochs-display,edid=on,xres=1920,yres=1080 \ -device qemu-xhci \ -drive if=none,id=stick,format=raw,file=daphnis-0.1.0-x86_64.img \ -device usb-storage,drive=stick
- The QEMU window opens on the first boot screen, the same screen a PC shows. Carry on at First boot below.
- To stop, choose Shut Down in Daphnis, and the QEMU window closes.
- To start Daphnis again, run the same command. Your accounts and files stay in the image file.
Run it on a PC from a USB drive
Use a USB drive to run Daphnis on a PC's own screen and keyboard, from the same disk image. There are three parts: write the drive, set the firmware, and start the PC on the first boot screen.
Write the USB drive
Writing the image erases the whole drive, so copy off any files you want to keep. To find the USB drive's device name, run this command once with the drive inserted and once with it removed; the line that comes and goes is the drive, and its NAME is the device name.
lsblk -d -o NAME,SIZE,MODEL
Then write the image, with the USB drive's device name in place of /dev/sdX. Write to the whole device, never to a partition such as /dev/sdX1.
sudo dd if=daphnis-0.1.0-x86_64.img of=/dev/sdX bs=4M conv=fsync status=progress
Any other tool that writes a raw image to a whole device does the same job.
Set the firmware
If the PC runs Windows with BitLocker or device encryption, have its recovery key at hand before you change anything. Windows may ask for it the next time it starts after a firmware setting changes.
Unplug every other USB drive. Daphnis uses only the first USB disk it finds, and keeps your home there only when that disk is this drive.
- Turn Secure Boot off in the firmware's setup. The boot loader on the drive is not signed, so with Secure Boot on the firmware refuses it.
- Open the firmware's boot menu and choose the USB drive's UEFI entry.
| computer | boot menu | Secure Boot |
|---|---|---|
| MSI MPG Z390 Gaming Edge AC | F11 | off on the tested board |
| HP Laptop 15-da0xxx | F9 | on by default; turn it off in setup, F10 |
The PC starts straight into Daphnis, with no menu in between.
First boot
- The first boot screen asks for a name, a Password, and the Password again. A name is up to 32 lowercase letters, digits and the hyphen. A Parent's password has 8 characters or more, and a Child's has 4 or more.
- Press Enter to make the account. This first account is a Parent; every account is either a Parent or a Child.
- From then on, every start ends at the login screen, which lists accounts with Parents first. Choose yours, type its password and press Enter.
To shut down from the first boot, login or lock screen, press Super+Esc.
The desk
Super is the key with the Windows logo on most PC keyboards.
| keys | action |
|---|---|
| Super, tapped alone | the Super plane: type to find an app or a file, Enter opens it |
| Super+Enter | a new Console, tiled |
| Alt+Tab | the switcher: hold Alt, press Tab to move, release Alt to choose |
| Super+1 to Super+9 | desktop 1 to 9 |
| F11 | the focused window fills the screen |
| Super+L | lock |
An app you open from the Super plane or from Index floats, and an app you open with a Super+ combination tiles. The app's name in the bar at the top is its menu.
Index is the file browser. It opens your home folder, which holds Documents, Downloads and Pictures.
Settings to make first
- Accounts: add a second Parent. There is no recovery key yet, and only a Parent can reset another account's password, so a second Parent can reset yours if you forget it.
- Date and Time: choose the city for the clock.
- Display: set Size to 1x, 2x or 3x, and the theme to Dark or Light.
When a prompt asks for a password
A prompt appears when a program wants more than its account holds: the disk, the network, sound, or the kernel's own rights. The system's prompt shows an AUTH mark in the bar, and a Parent's password answers it.
Inside a session, a password box without the AUTH mark is not the system's, so do not type a password into it.
Shut down
Tap Super and press the power button at the foot of the plane for Lock, Shut Down and Restart. Shut Down and Restart ask first only when something is unsaved, and Shut Down turns the computer off.
Switch User and Sleep are in the menu but do not work yet.