Orka 2.4.x content
This page has not been updated to reflect the changes introduced in Orka 3.0. Some of the information might be outdated or incorrect. Use 2.4.x to 3.0.0: API Mapping and 2.4.x to 3.0.0: CLI Mapping to figure out the correct endpoints and commands.
Some default macOS images are clean macOS installations. On these images, the OS setup is not complete (region settings, Apple ID login, etc.) and SSH and Apple Screen Sharing are not enabled.
If you want to create an SSH-enabled image, you need to deploy a VM with a clean Orka base image, complete the OS setup, and enable SSH manually. After that you can save a new SSH-enabled image for future use.
On this page, you will learn how to:
Quick command summary
orka image list
orka vm create
orka vm status
orka image save
orka image deploy
- Connect to your Orka environment via VPN.
- Log in with your Orka user.
Use one of the clean macOS images provided by Orka to deploy a fresh VM.
- List the available macOS images.
orka image list
- Create a VM with a clean image. The following example creates a small VM with a clean Mojave installation and 6 CPU cores.
orka vm create -v my-ssh-vm -b Catalina.img -c 6 -C 6 -y
When the deployment completes, Orka lists the following confirmation:
Create Status: Successfully Created Deploy Status: Successfully deployed VM
You need to connect to the VM via VNC and complete the OS setup.
- Get the IP and VNC port for the newly deployed VM. Note down the ID of the VM because you will need it later.
orka vm status -v my-ssh-vm -y
You should see a similar output:
Deployed Name my-ssh-vm ID 8425e425980db Owner [email protected] Node macpro-2 (UP) IP 10.10.10.5 VNC :5999 Screenshare :5900 SSH :8822 vCPU|CPU 6|6 RAM 15GB Base image Catalina.img Status running
- Launch your VNC client and provide the VM's IP and VNC port.
- When prompted, complete the OS setup. Note that you can skip providing an Apple ID.
You need to enable remote login on the VM.
- Launch System Preferences.
- Go to Sharing.
- Verify that Remote Login is enabled.
- Quit System Preferences.
- Restart the VM from the OS. (An
orka stop && orka startrestart won't work.)
- Verify that the SSH connection works.
You need to save the VM as a new image.
- Use the VM ID you obtained earlier to save it as a new image.
orka image save -v 8425e425980db -b my-ssh-image.img -y
This operation might take a while. When the operation completes, Orka shows a
saved confirmation message.
Create and deploy VMs based on the SSH-enabled image.
orka vm deploy -v my-new-vm -b my-ssh-image.img -c 6 -C 6 -y
Updated 5 days ago