> 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/panduan-untuk-enterprise/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="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-452eb12e0929d7e73018a0bc7cb915701afebc5d%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

## Flags

{% hint style="info" %}
This command supports [global flags](/panduan-untuk-enterprise/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.                               |