> For the complete documentation index, see [llms.txt](https://docs.cloud.olakrutrim.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloud.olakrutrim.com/basics/core-infrastructure/compute/easydeploy.md).

# EasyDeploy

Deploy pre-configured AI environments on Krutrim Cloud with one-click templates like OpenClaw, Hermes Agent, and Jupyter Notebook.

Krutrim EasyDeploy lets you launch pre-configured AI environments on Krutrim Cloud with one-click templates. It provisions a Virtual Machine with the required software stack, dependencies, runtimes, and application code already installed.

## Overview

EasyDeploy currently supports three templates:

* **OpenClaw:** A pre-configured environment for deploying autonomous AI agents.
* **Hermes Agent:** A self-hosted AI agent with a browser dashboard, powered by Krutrim inference.
* **Jupyter Notebook:** A ready-to-use workspace for data science and model experimentation.

| Template Name    | Use Case          | Default Port  | VM Name Prefix |
| ---------------- | ----------------- | ------------- | -------------- |
| OpenClaw         | Autonomous Agents | `443` (HTTPS) | `openclaw_`    |
| Hermes Agent     | AI Agent          | `443` (HTTPS) | `hermes_`      |
| Jupyter Notebook | Data Science / ML | `8888` (HTTP) | `jupyter_`     |

## Deploy OpenClaw

OpenClaw is an autonomous agent ecosystem tailored for Indian developers. The EasyDeploy flow automates the provisioning of the orchestrator and reasoning engine.

### Prerequisites

{% hint style="info" %}
Before launching, ensure you have created the required networking dependencies.
{% endhint %}

* **VPC and subnet:** Select your preferred Virtual Private Cloud and specific subnet.
* **Security group:** Ensure your Security Group allows inbound traffic on port `443` for web access.
* **API key:** You must provide or create an [API key](https://docs.cloud.olakrutrim.com/basics/key-management-system/model-api-keys.md) to serve as the agent's reasoning "brain".

### Deploy

{% stepper %}
{% step %}

### Provision the instance

Navigate to the EasyDeploy tab in the Krutrim Console, select "OpenClaw," and click Deploy.
{% endstep %}

{% step %}

### Confirm the instance is running

Once the status changes from "Provisioning" to "Running," the VM will appear in your "My Instances" list with the prefix `openclaw_` (e.g., `openclaw_assistant_01`).
{% endstep %}

{% step %}

### Open the Web UI

You can access the OpenClaw Web UI directly via the public IP:

`https://<VM_IP>/`
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Pricing:** Pricing for this feature is the same as standard VM pricing for the selected flavor, with no additional charges.
{% endhint %}

{% hint style="warning" %}
**Disclaimer:** The data you expose using OpenClaw is strictly your responsibility. Krutrim is not responsible for any data exposure, as OpenClaw is an open-source software. Please refer to the [OpenClaw GitHub repository](https://github.com/openclaw-rocks/openclaw-operator) for the source code and official documentation.
{% endhint %}

## Deploy Hermes Agent

Hermes Agent is an open-source AI agent by Nous Research. EasyDeploy sets it up on a dedicated VM with a browser dashboard, connected to Krutrim inference. The agent's terminal and code tools run inside an isolated Docker container on the VM.

### Prerequisites

{% hint style="info" %}
Before launching, ensure you have created the required networking dependencies.
{% endhint %}

* **VPC and subnet:** Select your preferred Virtual Private Cloud and specific subnet.
* **Security group:**
  * **Inbound:** allow port `443` (HTTPS) for web access. No other inbound port is needed.
  * **Outbound:** allow HTTPS (`443`) and DNS (`53`). The agent calls Krutrim inference over the internet; without outbound access the dashboard opens but the model does not respond.
* **Disk:** Select a root volume of at least 100 GB.

### Deploy

{% stepper %}
{% step %}

### Configure and provision the instance

Navigate to the EasyDeploy tab in the Krutrim Console, select "Hermes Agent," and click Deploy. Provide the following details:

* **Gateway Password:** the password you will use to sign in to the dashboard. 8 to 128 characters, using letters, numbers and `. _ ~ + / = @ % ^ -`.
* **Model Name:** the Krutrim model the agent should use (e.g., Qwen3.5-9B).
* **API key:** a Krutrim Cloud [API key](https://docs.cloud.olakrutrim.com/basics/key-management-system/model-api-keys.md).
  {% endstep %}

{% step %}

### Confirm the instance is running

Once the status changes from "Provisioning" to "Running," the VM will appear in your "My Instances" list with the prefix `hermes_` (e.g., `hermes_agent_01`).
{% endstep %}

{% step %}

### Open the dashboard and sign in

Open the Hermes dashboard directly via the public IP:

`https://<VM_IP>/`

Enter your Gateway Password. Only the password is required.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Notes**

* **First start:** The VM finishes its first-time setup after it shows "Running." For the first one to two minutes the page shows "Hermes is starting" and refreshes automatically until the sign-in screen appears. If you see a gateway error instead, wait a minute and reload the page.
* **Response time:** Reasoning models think before they answer, so the first reply can take several seconds.
* **Changing the API key:** The [API key](https://docs.cloud.olakrutrim.com/basics/key-management-system/model-api-keys.md) is set when the VM is created. To use a different key, deploy a new Hermes VM.
  {% endhint %}

{% hint style="info" %}
**Pricing:** Pricing for this feature is the same as standard VM pricing for the selected flavor, with no additional charges.
{% endhint %}

{% hint style="warning" %}
**Disclaimer:** The data you expose using Hermes Agent is strictly your responsibility. Krutrim is not responsible for any data exposure, as Hermes Agent is an open-source software. Please refer to the [Hermes Agent GitHub repository](https://github.com/NousResearch/hermes-agent) for the source code and official documentation.
{% endhint %}

## Deploy Jupyter Notebook

The Jupyter Notebook template provides a sandboxed environment with pre-installed Python libraries and ML tools.

### Prerequisites

{% hint style="info" %}
Configure the foundational networking components.
{% endhint %}

* **VPC and subnet:** Identify the region and network for deployment.
* **Security group:** Open port `8888` in your Security Group configuration to allow browser access to the Jupyter server.

### Deploy

{% stepper %}
{% step %}

### Select the template

Select the Jupyter Notebook template from the EasyDeploy menu.
{% endstep %}

{% step %}

### Confirm the instance is running

Monitor the deployment progress in the dashboard. The VM will be created with the prefix `jupyter_` (e.g., `jupyter_research_env`).
{% endstep %}

{% step %}

### Open the notebook

Access your notebook environment using the following URL:

`http://<VM_IP>:8888`
{% endstep %}
{% endstepper %}

## Post-Deployment Management

All instances created via EasyDeploy will appear in the "My Instances" page with their respective prefixes. From there, you can perform the following lifecycle operations through the Krutrim Console:

* **View:** Track status and resource utilization.
* **Start/Stop:** Manage costs by pausing instances when not in use.
* **Delete:** Remove instances and associated block storage when no longer required.

## Troubleshooting and best practices

* **Networking:** If the VM is "Running" but the URL is inaccessible, verify that your Security Group explicitly allows ingress on the required ports (`443` for OpenClaw and Hermes Agent, `8888` for Jupyter).
* **Startup:** OpenClaw and Hermes Agent need one to two minutes after the VM shows "Running" to finish their first-time setup. If the page shows a starting message or a gateway error, wait and reload.
* **API Keys:** For OpenClaw and Hermes Agent, ensure your [API key](https://docs.cloud.olakrutrim.com/basics/key-management-system/model-api-keys.md) is valid and has sufficient token limits to avoid inference failures.
* **Model not responding (Hermes Agent and OpenClaw):** If the dashboard opens but the agent does not answer, check that your Security Group allows outbound HTTPS (`443`) and DNS (`53`), and that your subnet has a working DNS server. Also confirm the model name you entered is available on Krutrim Cloud.
* **Identification:** Always check for the `openclaw_`, `hermes_` or `jupyter_` prefix in the instance list to distinguish EasyDeploy VMs from standard compute instances.
