Docs: Configuration

AcornOS documentation

Configuration

Installation steps 10-14. Run these commands in the live shell, with the installed system mounted at /mnt. The first recsetup apply on the release medium starts by installing the default software through Recipe, then applies your machine's choices using the setup program shipped in that system.

10. Inspect Available Choices

Note
Option 1, the helper app: system-setup asks for the keyboard layout, time zone, language, hostname, root password and a user, shows the commands recsetup would run, and applies them after you confirm. When it has applied them, go to Boot & Finish. Option 2, by hand: skip system-setup and use the commands in this page's steps. Either way the system is configured, not installed: it still needs its boot files.
Note
Software first, and it takes some minutes. The base system holds only what boots the machine and runs Recipe. The first recsetup apply on the release medium installs the default software through recipe --system install: the desktop (LXQt), Firefox, audio, networkmanager, Bluetooth, printing, the firewall, fonts and the rest. It reads them from a package cache on the medium, so no network is needed, and each one gets a Recipe receipt, so you can remove or replace it later in Recipe, the desktop included. Wait for it to finish.
Answer the questions, review and apply
system-setup
Warning
Skip this - only if doing it by hand. system-setup lists these choices itself.
List the target's timezones, locales, keymaps, shells, groups and services
recsetup inspect --root /mnt --json

11. Set Timezone, Locale and Keymap

Warning
Skip this - only if doing it by hand. system-setup already set these.
Preview your choices
recsetup plan --root /mnt --timezone Europe/Brussels --locale en_US.UTF-8
Apply timezone, locale and keymap
recsetup apply --root /mnt --timezone Europe/Brussels --locale en_US.UTF-8 --keymap us

Choose values listed by recsetup inspect. musl compiles no locales, so the locale only sets LANG in /etc/locale.conf. The keymap is the console layout the system loads at boot; leave --keymap out for the US layout.

12. Set Hostname

Warning
Skip this - only if doing it by hand. system-setup already set the hostname.
Set hostname and its hosts-file mapping
recsetup apply --root /mnt --hostname acornos

13. Set Root Password

Warning
Skip this - only if doing it by hand. system-setup already set the root password.

The release image has a locked root account. Set a password interactively; it is never stored in a setup request or passed as a command argument.

Set the installed root password
recchroot /mnt -- passwd

14. Create User Account

Warning
Skip this - only if doing it by hand. system-setup already created the user.
Create an administrator without putting a password in the request, then set it
printf '%s\n' '{"users":[{"name":"yourname","admin":true,"password":false}]}' > /tmp/user-setup.json
recsetup apply --root /mnt --request /tmp/user-setup.json
recchroot /mnt -- passwd yourname

An administrator joins wheel. The system recipe already ships the doas rule for wheel (permit persist :wheel in /etc/doas.conf), so administrative commands go through doas.

Continue to Boot & Finish. It is required: the system is not installed until it has run.