Server registration token

Server registration tokens are used for automated server onboarding via the CLI. Instead of registering servers one by one through the web UI, you can use a registration token to register multiple servers programmatically.


Token list

You can check Name, Allowed groups count, Valid through, and Added date for each token.

Create token

  1. Click the Add button.
  2. Set the token Name.
  3. Set Expiration (7 days, 30 days, 60 days, 90 days, 1 year, custom, or no expiration).
  4. Select Allowed groups to define which groups the registered servers will be assigned to.
  5. Click Create.
  6. The generated token key is displayed on the detail screen. Copy and store it in a safe location—it cannot be retrieved after leaving 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.

Token detail

Click on a token in the list to view its detail screen.

Token information

View the token’s name, expiration date, creation date, and connected groups.

Token management

FunctionDescription
Update tokenModify the token’s name, expiration, and allowed groups.
Delete tokenPermanently delete the token.

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 wizard, or create a new one on the spot.

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