Repository navigation
First boot setup
A fresh install has no user. derisk setup (nixos/modules/setup.nix) runs
on tty1 as a logind session of its own, after homed and before the display
manager, and draws derisk's pages on the seat: language, keyboard layout,
time zone, network, then the first account (full name, user name, password).
It saves them with localectl set-locale, localectl set-x11-keymap,
timedatectl set-timezone and homectl create --member-of=wheel, the
password passed in NEWPASSWORD and never on a command line, and exits.
The keyboard layout switches live as it is picked, and the display manager
hands localed's saved layout to the login screen and the session as
xkbcommon's defaults.

It runs on every boot and exits at once when userdbctl lists a regular
user, so a machine switched off halfway through asks again. If derisk cannot
draw at all, homed's console wizard asks for the user instead. homed's own
first-boot unit is kept for home.create.* credentials, without its prompt.
The languages offered are the locales built into the archive, the thirty-odd
derisk has names for, and i18n.imperativeLocale lets localed's choices
stick. On a phone-sized screen the pages fill the screen and the on-screen
keyboard opens under a focused field; on a PC the card floats and the
keyboard is a button in the corner.
The person who just chose the password is not asked for it again a minute
later. Setup leaves a ticket, the user name and password in
/run/derisk-first-login (root's, mode 0600, on a tmpfs so it never reaches
a disk), and the display manager takes it before it starts the login
screen: it deletes the file first, then logs that user in through the same
derisk-login PAM stack, so homed unlocks the home area as usual. A ticket
that is not root's, not private, a symlink or older than ten minutes is
deleted and ignored. Only that first login skips the login screen; every
later boot and every log out shows it. The session then opens on a short
tour of the desktop (the top bar, the window buttons, search, the overview,
and the keys for each), which leaves a mark in ~/.local/state/derisk once
finished or skipped; "Take the Tour" in the command palette shows it again.
The boot VM test (nixos/tests/boot.nix) writes a ticket by hand and checks
the session starts without the login screen and the ticket is gone.
Generated from docs/ in the repository at every change; edit the pages there, since an edit made here is overwritten.
- LosOS Desktop
- Building
- When something goes wrong
- Reporting a problem
-
The system
- Everything systemd, and the exceptions
- Virtual machine desktop
- Peripherals in machines of their own
- The network machine
- The files machine
- The portal machine
- Where the OS lives
- Hibernation
- Hardware and NVIDIA
- Boot loader and boot screen
- Secure Boot
- The installer
- The Windows installer
- Trying it in quickemu
- First-boot setup
- Signing in
- Security keys and smart cards
- More than one person
- Company accounts
- Releases and GHCR
- The memory allocator
- The security report
- Kernel hardening
- Schizo mode
- VPN
-
Desktop and apps
- GTK and Qt on a phone
- One icon theme
- Danube
- System-wide ad blocking
- The terminal
- Ask derisk
- The Store
- The Agent
- Active users and the choice screens
- LosOS boxes
- Windows app support
- The gaming machine
- Focus mode
- Android app support
- macOS app support
- arm64 macOS machines
- App windows
- Backups to a LosOS box
- Screenshots
- Building blocks
- Phones
- History and gaps