Using self-hosted agent types#

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#

  1. Go to <your-organization-name>.semaphoreci.com/self_hosted_agents
  2. Click the Add a self-hosted agent type button
  3. Give it a name and click Looks good. Register
  4. Your agent type should be created. Follow the instructions to install the agent in your operating system of choice. The instructions are also available here.

Using a self-hosted agent type in your pipelines#

To use a self-hosted agent type in your pipelines, the machine type on 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 in the agents you registered for that type.