# stop

The cldkctl vm stop command powers off a virtual machine (VM) by specifying its name. This command gracefully shuts down the VM, ensuring data integrity before releasing allocated resources. It is typically used to stop a running VM to reduce resource usage when the VM is not needed. Ensure that you have the necessary permissions to perform this operation and that the VM is currently in a Running state before stopping it.

## Usage

```
cldkctl vm stop [name] [flags]
```

## Aliases

```
stop, turn-off, off, shutdown
```

## Steps

Follow the steps below to run and view the result of this command:

1. Run the following command in your terminal and replace \<vm\_name> with your virtual machine name.

```
cldkctl vm stop <vm_name>
```

2. Ensure that you have the appropriate permissions and that the VM is currently in a Running state.
3. The command initiates a graceful shutdown, preserving data integrity and releasing allocated resources.
4. Once the shutdown is complete, a confirmation message “Virtual Machine stopped” appears in the terminal

<figure><img src="/files/76FHkTBTxklKHCWzu1HW" alt=""><figcaption></figcaption></figure>

## Flags

{% hint style="info" %}
This command supports [global flags](/cloudeka-api-list/global-flags.md). Refer to the Global Flags section for details
{% endhint %}

| Flag                   | Description                                             |
| ---------------------- | ------------------------------------------------------- |
| -h, --help             | Help for the vm stop command.                           |
| -n, --namespace string | Specifies the cluster namespace to scope the operation. |
| -p, --project string   | Specifies the project ID.                               |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cloudeka.ai/cloudeka-api-list/command-reference/cldkctl-vm/stop.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.