> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axottle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Node registration

> Automatic SSH registration and manual installation via enrollment token.

The Axottle Agent can be registered automatically via SSH or manually. The Enrollment Token is always used for the first connection of the agent, but when installed over SSH, the panel manages it itself.

## Automatically over SSH.

1. Open **Nodes** and press **Add nodu** or open an existing node → **Agent**.
2. Select **Automatic installation by SSH**.
3. Specify the address, port, user and authentication method.
4. Run the SSH check and confirm the installation.
5. Wait for the registration stage and the first heartbeat.

The panel automatically creates a temporary enrollment token and recalls it after installation. You do not need to press the token generation button separately.

## Manually via enrollment token

1. Open **Nodes** and select the server.
2. Go to the tab **Agent**.
3. In **Manual installation** press **C generate enrollment token**.
4. Copy the finished command that the panel will show.
5. Run it in root-shell nodes.

The token is disposable, is valid for 30 minutes by default and is fully displayed only when created.

## View active tokens

At the bottom of the tab **Agent** is the block **Active enrollment tokens**. These are manually installed tokens; for each prefix and expiration date are visible.

The used token disappears from the active list, and the registered agent’s status is displayed at the top of the tab.

## Withdraw the token

Find the token in the block **Active enrollment tokens** and click the recall button in its line. After the withdrawal, you can not register for it.

## Re-registration

If the agent’s permanent token is compromised or the agent has lost registration:

1. Create a new enrollment token.
2. Repeat the installation or registration;
3. Make sure that the **Agent** tab shows the state of `online` and fresh heartbeat.

The re-registration rotates the agent's permanent token, and the old instance of the agent with the old token will stop connecting.

## Verification

> [!TIP]
>
> Tab **Agent.** It shows the node online, the time of the last heartbeat and the agent’s capabilities.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.