Skip to content

users

import { createUser, deleteUser, createGroup, deleteGroup } from 'sysopkit/op/users';

IDEMPOTENT

Creates a system user.

await createUser({
user: 'app',
uid: 1001,
home: '/home/app',
shell: '/bin/bash',
groups: ['www-data'],
});

Supplementary groups are ensured via usermod -aG — missing memberships are appended, existing ones never removed. For exact member lists use createGroup({ members }). Listed groups must already exist (create them with createGroup first).

IDEMPOTENT

Removes a user.

await deleteUser({ user: 'app' });

IDEMPOTENT

Creates or removes a group.

await createGroup({ name: 'app', gid: 1001 });
await deleteGroup({ name: 'old-group' });