Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Remote Machines

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

Remote Machines is available only when it has been enabled for your organization. If Remote Machines doesn't appear in Settings, contact Autify support.

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, later in this article.

  10. Click Test connection. On the first connection, the confirmation dialog described in Verifying a machine's identity, later in this article, appears.

  11. After the connection test succeeds, click Save.

The private key, passphrase, and password you enter are encrypted at rest.

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.

Deleting a machine means Genesis Agents can no longer run commands on it. This cannot be undone.

Further reading

PreviousApps
NextBasic support information

Last updated