---
title: "Manage server registration tokens"
description: "Use server registration tokens to onboard new servers in Alpacon. Set allowed groups and expiration, then create or select a token during registration."
---

> Full documentation index: https://docs.alpacax.com/llms.txt

# Manage server registration tokens

<span id="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.

Superusers can manage registration tokens under [server access policy](/use/policies/server-access/). You can also create or select a token during [server registration](/use/servers/register/).

---

## Create a token during registration

In the server registration flow, choose **Registration with token**. Under **Server registration tokens**, select an existing token, or click **Create new token** and set:

1. **Name**—a name you can recognize later
2. **Expiration** (7 days, 30 days, 90 days, 1 year, or custom): starts at 1 year, or **Maximum token lifetime** when shorter. Set the maximum under [server access policy](/use/policies/server-access/) (1–366 days, default 366) for personal and registration tokens; service tokens are excluded. Every registration token expires. If the API request omits the date, it uses the workspace maximum.
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](/use/servers/register/#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](/use/servers/register/).

Source: https://docs.alpacax.com/use/servers/register/tokens/
