Agent installation
On-prem agent installation
Create new agent
You can also use the API to create an Agent.
Go to Workspace settings > On-premise and click the Create On-premise connection button.
You will see an activation code that you can use to register the agent at installation. Download the agent by following the Download install agent link, and copy the Registration token:
**
**The 'Agent activation status' will remain as 'Waiting for connection' until the agent is activated on your target machine, when it will change to a green Connected message
Key points on the agent activation code:
- The registration token is only valid for 60 minutes
- It is one-time use only
- Each agent instance requires its own activation code
Windows machine setup
Running the agent in PowerShell
- Copy the activation code generated for you and execute the downloaded agent by typing the following command in your PowerShell terminal:
> C:\Path\to\agent-win-amd64.exe register <activation_code> - Finally, once the agent has been registered, execute it by typing the following command in your PowerShell terminal:
> C:\Path\to\agent-win-amd64.exe run
Setting up the agent as a Windows Service
Alternatively, you can also run this as a Windows Service.
- Type the following command in your PowerShell terminal:
> New-Service -Name "TrayOnPremAgent" -BinaryPathName "C:\Path\to\agent-win-amd64.exe run --registration-token=<activation_code>" - Now start the service with:
> Start-Service -Name "TrayOnPremAgent"
Linux machine setup
Running the agent in the terminal
Run the following commands (depending on your chip):
chmod +x agent-linux-amd64
./agent-linux-amd64 register <activation_code>
./agent-linux-amd64 run
The agent should install and run successfully and you will see requests coming in to the terminal.
Installing the agent as a service
You can wrap up the above commands into whichever service manager (systemd, OpenRC etc.) you use and install the agent as a service.
Deleting an agent
You can also use the API to delete an Agent.
Agents can be deleted via the Tray UI. A deleted agent will no longer be able to connect to Tray. If you remove the last agent from a group, then any workflows which rely on authentications made to this agent group will fail. Therefore it is important to edit these workflows and authentications before deletion, to ensure there is no downtime for the workflow.