Using self-hosted agent types#
Available on: Free & OS Startup Scaleup
Before running and using self-hosted agents in your pipelines, you need to register a new agent type in your organization.
Creating a self-hosted agent type#
- Go to
<your-organization-name>.semaphoreci.com/self_hosted_agents
- Click the
Add a self-hosted agent type
button - Add a name and click
Looks good. Register
- Your agent type should be created. Follow the instructions to install the agent on your operating system of choice. The instructions are also available here.
Required permissions to add a new self-hosted agent type
Only users with the Admin permission level can add a new self-hosted agent type.
Using a self-hosted agent type in your pipelines#
To use a self-hosted agent type in your pipelines, the machine type in the agent definition of your pipeline needs to be updated. For example, if you named your self-hosted machine type s1-linux-small, use this configuration:
agent:
machine:
- os_image: ubuntu1804
- type: e1-standard-2
+ type: s1-linux-small
And that's it. Now jobs using that agent type will run on the agents you registered for that type.