> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macstadium.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OCI Images: Deploy VMs

> Deploy an Orka VM from any OCI-compatible image by specifying the registry address. Private registries require credentials pre-configured in the namespace.

Using an OCI image in your workloads is as simple as just deploying a VM and specifying the address of the image in the registry. If you are working with a private registry, you need to have the [registry credentials configured in the respective namespace](/orka/oci-images/oci-images-manage-registry-credentials) before attempting to deploy.

#### **Orka CLI**

```
orka3 vm deploy --image <SERVER_ADDRESS>/<IMAGE>[:<TAG>]  
  
OR  
  
orka3 vm deploy --image <SERVER_ADDRESS>/<IMAGE>[:<TAG>] --namespace <NAMESPACE>
```

#### **Orka API**

```
curl -X 'POST' \  
'<ORKA_API_URL>/api/v1/namespaces/<NAMESPACE>/vms' \  
-H 'accept: application/json' \  
-H 'Authorization: Bearer <TOKEN>'  
-H 'Content-Type: application/json' \  
-d '{  
"image": "<SERVER_ADDRESS>/<IMAGE>[:<TAG>]"  
}'
```

Note that you need to provide the registry path to the image name and optionally its tag. For example: ghcr.io/my-organization/orka-images/orka-arm:latest.

You can add as many or as few configuration options as you need, including a user-specified name. If you are using the Orka3 CLI, run orka3 vm deploy --help for more information. If you are using the Orka3 API, see [Deploy a VM](https://macstadium.github.io/orka-api-docs/#tag/VMs/operation/vmDeploy).

**Did you know?**

You can find MacStadium's public vanilla macOS images at [https://github.com/macstadium/orka-images.](https://github.com/macstadium/orka-images)