Cloud Machine Setup and Agent Deployment

Before an agent can run, you must prepare the remote Machine that will host it.

Steps to create a remote Machine:

• Navigate to Admin Settings and click 'Compute Configuration'

• Click 'Add Compute'.

• Fill in the details:

  • Name & Type: Fill in the Compute Name and select the type.

  • Connection: Enter the Host / IP (internet address) and the SSH Port (usually 22).

  • Authentication: Provide the Username and Password/SSH Key so the system can access the server.

  
• Define the Environment: Enter the Docker Image path (e.g., walnut-cloud-agent:latest). If the image is private, provide the Registry Server, Username, and PAT.

• Assign a Subdomain: Assign a unique URL (e.g., agent2.walnut.ai) for browser-based access. Ensure the domain's A record points to your VM IP.

• Validate & Provision:

  • Click Test to confirm the credentials and network settings are correct.

  • Click Update VM: This autonomously installs Docker, configures, performs DNS mapping, and pulls the latest Code Editor Docker images.

  

Steps to Create a Cloud Agent

Once the machine status is Active and the environment is fully provisioned, you can deploy the agent.

• Go to the Agents and click 'New Agent'.

• Provide a name for the agent and select the Compute Instance you just created from the dropdown menu.

• Click 'Create'.

What Happens Next?

Once created, your agent will sit in an Idle state. It consumes minimal resources while waiting for a task to be assigned. As soon as a task enters its queue, it will wake up and begin execution.