Server registration token

Server registration tokens authorize automated server onboarding. A single token can register one or many servers, and the token determines which user groups the registered servers are assigned to.

Note: Manage server registration tokens under Workspace settings > Access > Server registration (superuser only). You can also create or select a token inline during the server registration flow.

Create a token during registration

In the server registration flow, choose Registration with token. In the Registration token field, select an existing token from the dropdown, or click Create new token and set:

1. Name
2. Expiration (7 days, 30 days, 90 days, 1 year, custom, or no expiration)
3. Allowed groups—which groups the servers registered with this token are assigned to

The generated token key is displayed only once. Copy and store it in a safe location—it cannot be retrieved after you leave the page.

Allowed groups

When creating a server registration token, you specify which groups the servers registered with this token will be assigned to.

All groups

Servers registered with this token can be assigned to any group in the workspace.

Admins only

Only workspace administrators can access the servers registered with this token.

Specific groups

Only the selected groups are available. When selecting groups:

• Regular members can only see groups they belong to.
• Staff and superuser members can see all groups in the workspace.

Using registration tokens

Server registration tokens are used with the Registration with token method during server registration. Select the token from the dropdown during the registration flow, or create a new one on the spot.

For a complete guide on server registration methods, see Register a server.