Hyprnux First Start

Language, keyboard, disk passphrase and your first account, in up to seven short steps.

Only the Hyprnux installer turns it on: on your own Arch it has no visible effect.

Read the docs

Package: hyprnux-firstboot
License: MIT
Needs: A machine with no user account

The first-start assistant asking for the language of the computer.

What it does

Up to seven short steps

Language, keyboard, time zone, computer name, disk passphrase, your account, then Finish. Next applies each answer and Back returns to the previous step.

Your first account

You give a full name (optional), a user name and a password of at least 8 characters. The account can use administrator rights and root stays locked.

Disk passphrase

Only when the installer encrypted the disk with a temporary passphrase: the assistant asks for your own. You can keep the temporary one, but the screen warns against it.

Why you would want it

It runs once

It appears only on a machine with no user account. After the last step it never appears again, even with the package still installed.

A power cut does not break it

Each step is applied when you press Next, so a restart resumes at the first step not yet done. A half-made account is removed and asked for again.

It keeps your password to itself

The password is sent once and does not reach a command line, a file or the system journal.

After you install it

Start the freshly installed computer.
Go through the steps. Press Next to apply an answer.
On the last screen, press Finish and sign in with the user name and password you chose.

Install it on its own

Before you start. A machine with no user account, which is what the Hyprnux installer leaves.

Packaged for pacman, on Arch Linux. Add the Hyprnux repository once first: Install Hyprnux. On another distribution, build it from its sources.

sudo pacman -S hyprnux-firstboot

It does not run on your own Arch: only the Hyprnux installer turns it on. Installing it also pulls in dracut and adds a hyprnux-greeter group. With mkinitcpio, every kernel update then builds the boot image twice; the install guide shows how to keep one build.

The steps show on the Hyprnux login screen. If the setup service does not answer, a text assistant on the first console (tty1) asks the same questions. The assistant creates one account only. Wi-Fi and the look of the desktop stay in Settings.

Remove it

sudo pacman -Rns hyprnux-firstboot

If something goes wrong, see the install guide.