People are listed under users: in the computer’s computer.nami. Each person’s own apps and settings are in their user.nami.
Add people
Each entry is a login name. An admin can change the computer; anyone else can change only their own setup.
packages: - namiosusers: ada: admin: true # may change the computer, and use sudo name: Ada Lovelace # shown on the login screen sam: name: Sam groups: [docker] # more groups, as usermod -aG adds themA login name is lowercase letters, digits, - and _, at most 32 characters. Everyone gets a home in /home/<login>.
On a running computer, an admin can do the same on the People page in Settings. Add User writes the new person in:
users: ada: admin: true name: Ada Lovelace sam: name: SamGive someone a password
A password never goes in the file as it is. Apply with the new person’s password on stdin:
echo 'sam:correct-horse' | nami apply --password-stdin
Without one, their account stays locked until an admin runs sudo passwd sam. When you make a USB drive, nami usb asks for each password instead.
You can also put a hash in the file, made with mkpasswd or openssl passwd -6, as password: $6$.... The computer sets it back on every apply, so leave it out if people should change their own password.
Take someone out
Remove their entry and apply. They can’t log in any more, and their files stay; put them back and they log in with their old password.
Set limits for a child
A child has their own login, but no sudo and no apps of their own: they use the computer’s apps, which an admin chooses.
packages: - namiosusers: ada: { admin: true } sam: child: true hours: 07:00-20:00 # can log in only then; the session ends at 20:00 without: [discord, steam, ghostty] # off Sam's menu and searchAn admin can set the same on the People page. Leave out hours or without for no limit. A child’s own user.nami can hold settings and dotfiles, but no packages: or services:.
Add the terminal to without: too, since a child with a terminal can start a blocked app from it. namiOS’s own desktop keeps the hours but doesn’t hide without: apps yet; GNOME does both.
Keep everyone’s files in a config repo
In a config repo, each person’s file sits in the computer’s folder, under their login. On namiOS, it’s applied at their first login.
nami-config/
└── laptop/
├── computer.nami # users: ada, sam
├── ada/user.nami
└── sam/user.nami