Skip to main content
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

Tab Agent. It shows the node online, the time of the last heartbeat and the agent’s capabilities.