nami alpha Docs

People and parental controls

Choose who can log in to a namiOS computer, give each person a password, and set limits for a child.

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.

/etc/nami/computer.nami
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 them

A 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:

/etc/nami/computer.nami
users:  ada:    admin: true    name: Ada Lovelace  sam:    name: Sam

Give 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.

/etc/nami/computer.nami
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 search

An 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

Something wrong or missing here? nami report tells us, or Report a problem in the nami window.