Install the agent
Onboarding an instance installs the Alpamon agent so it becomes a managed Alpacon server. You can install with one click through AWS Systems Manager (SSM), or follow a manual SSH guide.
One-click install (AWS SSM)
On the instance inventory or an instance’s detail page, click Install agent. A progress dialog shows three steps:
- Dispatch — the install command is sent via AWS Systems Manager.
- Install — the agent is installed on the instance.
- Match — the instance is linked to its new Alpacon server (by tag, MAC, IP, or hostname).
When all three steps complete, click View server to open the new server. If a step fails or times out, an error is shown and you can Retry.
Manual install (SSH)
If one-click install isn’t available—for example on unsupported platforms—use Manual install guide. It shows the SSH command and install script to run on the instance yourself, with options to copy the SSH command (public or private IP) and the install script.
Note: The install script contains a plaintext registration token—don’t share it publicly. After you run it, the instance registers itself and is matched to a server.
When installation is blocked
If Install agent is unavailable, the instance shows a Blocked state with the reason and how to resolve it. Common reasons:
| Reason | How to resolve |
|---|---|
| Already managed | No action needed—the agent is already running. |
| Install in progress | Wait for the current install to finish. |
| Instance not running | Start the instance, then wait for the next sync. |
| Remote command unavailable | Register the instance as an AWS SSM managed node. |
| Unsupported platform | Install the agent manually and register—see the installation guide (for example, on Windows). |
| Account not active | Re-verify the account until its status is Active. |
| Remote command disabled | Enable remote command in the account settings. |
| Registration token missing | Attach a server registration token to the account. |
After onboarding
Onboarded instances appear under Servers and are accessed through work sessions, just like any other server.