> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/settings/connection-settings/remote-machines.md).

# Remote Machines

Connect your own machine over SSH so Genesis Agents can run commands on it by name ("bring your own compute").

{% hint style="warning" %}
Remote Machines is available only when it has been enabled for your organization. If **Remote Machines** doesn't appear in Settings, contact Autify support.
{% endhint %}

## Prerequisites

* To add, edit, delete, or enable/disable a machine, you need the organization **Admin** or **Owner** role. The **Member** role can only view registered machines.
* The machine you add must be reachable over SSH, and you need a username and credentials (a private key or a password) for connecting to it.

## Adding a machine

1. Open **Settings** from the account menu in the lower-left corner, and click **Connections** > **Remote Machines** in the left sidebar.
2. Click **Add machine**.
3. In **Name**, enter the name Genesis Agents use to reference this machine.
4. In **Description**, enter what this machine is for (optional). It's shown to Genesis Agents to help them pick the right machine.
5. In **Host** and **Port**, enter the SSH host you're connecting to (for example: `example.com` or `10.0.0.5`) and the port number (the default is `22`).
6. In **Username**, enter the username used to connect over SSH.
7. In **Authentication**, select **Private key** or **Password**.
8. Enter the following fields depending on the authentication method you selected.

   | Authentication method | Fields                                                                      |
   | --------------------- | --------------------------------------------------------------------------- |
   | Private key           | **Private key (PEM)**, **Key passphrase** (if the key has a passphrase set) |
   | Password              | **Password**                                                                |
9. In **Availability**, set which workspaces can use this machine. See [Setting the availability](#setting-the-availability), later in this article.
10. Click **Test connection**. On the first connection, the confirmation dialog described in [Verifying a machine's identity](#verifying-a-machines-identity), later in this article, appears.
11. After the connection test succeeds, click **Save**.

{% hint style="info" %}
The private key, passphrase, and password you enter are encrypted at rest.
{% endhint %}

## Verifying a machine's identity

When you connect to a host for the first time, or after you change the host or port, Genesis retrieves the machine's SSH host key fingerprint before connecting and shows it in a confirmation dialog. Confirm that the displayed fingerprint matches the machine you're connecting to, then click **Trust and test**.

To re-fetch the host key for a registered machine, click **Re-verify identity** on the machine's edit screen. Re-verifying requires entering the current credentials.

## Setting the availability

You can set which workspaces can use each machine.

* Enabling **Available in all workspaces** lets Genesis Agents in every workspace in your organization use the machine.
* Disabling it restricts the machine to only the workspaces you select individually from the workspace list. You must select at least one workspace.

## Managing machines

The **Remote Machines** page lists each registered machine's name, authentication method, connection status (not tested yet / reachable / unreachable), and availability. For each machine, you can:

* **Test connection**: Verify the SSH connection to the machine using the saved credentials.
* **Enabled** switch: Toggle whether Genesis Agents can use the machine. The machine's registration is retained even when disabled.
* **Edit**: Change the name, connection details, authentication method, or availability.
* **Delete**: Remove the machine's registration.

{% hint style="danger" %}
Deleting a machine means Genesis Agents can no longer run commands on it. This cannot be undone.
{% endhint %}

## Further reading

* [Connections](/settings/connection-settings.md)
* [Tools](/ai-feature/tools.md)