User Management

Administrators can manage users, control registration, and configure global settings from the Administration panel.

Accessing the admin panel

Click your avatar (top right) → Settings → Administration.

Only users with the admin role can see this section.

Roles

pipel8ne has two roles:

Role	Permissions
user	Create and manage their own projects and pipelines; view public projects
admin	All user permissions + manage all users + access administration panel

Managing users

Creating a user

In Administration → Users, click New User:

Field	Description
Name	Display name
Email	Login email
Password	Initial password (the user should change it on first login)
Role	user or admin

Changing a user's role

Find the user in the list and click the Edit button. Change the role and save.

Deleting a user

Click the Delete button next to a user. Their account is permanently removed.

WARNING

Deleting a user does not delete their projects or pipelines. Those remain and can be accessed by other admins.

Registration settings

By default, anyone with access to the instance URL can create an account. To restrict this:

1. Go to Administration → Settings
2. Toggle Allow registration to off
3. Save

With registration disabled, only admins can create new accounts. Existing accounts are unaffected.

TIP

After setting up your instance and creating accounts for your team, it is recommended to disable public registration.

First admin account

The very first account registered on a fresh installation is automatically granted the admin role. All subsequent registrations get the user role.

If you need to promote an existing user to admin and cannot log in as an admin, you can do so directly in MongoDB:

# Connect to MongoDB
docker exec -it pipel8ne-mongo mongosh -u pipel8ne -p <password>

# Switch to database and update
use pipel8ne
db.users.updateOne(
  { email: "user@example.com" },
  { $set: { role: "admin" } }
)