> For the complete documentation index, see [llms.txt](https://docs.cloudeka.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudeka.ai/cloudeka-api-list/command-reference/cldkctl-vm/stop.md).

# 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.                               |