Images

🚧

Quick navigation

Listing: List images | List images in the remote repo

Upload and download: Upload an image | Download an image

Pull: Pull an image from the remote repo

Generate: Generate empty image

Management: Copy image | Rename an image | Delete an image | Resize an image

Save and commit: Create a new base image from a deployed VM | Update an existing base image by committing changes to it

🚧

Quick command summary

orka image list
orka image list-remote

orka image upload --image <FILE_PATH> -y
orka image download --image <NAME> --output <FILE_PATH> -y

orka image pull --image <REMOTE_IMAGE> -o <NEW_IMAGE_NAME> -y

orka image generate --image <NAME.img> -q <SIZE> -y

orka image copy --image <IMAGE> -o <NEW_IMAGE_NAME> -y
orka image rename --image <IMAGE> -o <NEW_IMAGE_NAME> -y
orka image delete --image <IMAGE> -y
orka image resize -v <VM_ID> -q <NEW_SIZE> --vm-username <VM_USERNAME> --vm-password <VM_PASSWORD> -o <NEW_IMAGE_NAME> -y 

orka image save -v <VM_ID> -b <NEW_IMAGE_NAME> -y
orka image commit -v <VM_ID> -y

List images

Command

List the base images available in your local Orka storage.

orka image list

OR

orka image list --json

OR

orka image list --raw

Options

You can pass the following options with orka image list in direct mode:

List images in the remote repo

Command

List the base images available in your remote Orka repo. MacStadium sets up and maintains the remote repo.

To use any of the images available in the remote repo, you need to pull them locally.

orka image list-remote

OR

orka image list-remote --json

OR

orka image list-remote --raw

Options

You can pass the following options with orka image list-remote in direct mode:

Upload an image

Command

Upload a base image from your local file system to the Orka local storage. The image format must be .raw or .qcow2.

📘

Known limitation

This command is applicable only to Intel images.

For more information, see Apple Silicon-Based Support.

orka image upload

OR

orka image upload --image <FILE_PATH> -y

Output

Options

You can pass the following options with orka image upload in direct mode:

Download an image

Command

Download a base image from the Orka cluster storage to your local filesystem.

📘

Known limitation

This command is only applicable to Intel images.

For more information, see Apple Silicon-Based Support.

orka image download

OR

orka image download --image <NAME> --output <FILE_PATH> -y

Options

You can pass the following options with orka image download in direct mode:

Pull an image from the remote repo

Command

Pull the specified base image from the remote repo. Orka clones the image in your local Orka storage and retains the original image in the remote repo.

orka image pull

OR

orka image pull --image <REMOTE_IMAGE> -y

OR (specify new name for the local copy)

orka image pull --image <REMOTE_IMAGE> -o <NEW_IMAGE_NAME> -y

Output

Options

You can pass the following options with orka image pull in direct mode:

Generate empty image

Command

Generate an empty base image of the specified size. You can set the size in k, M, G, and T (for kilobytes, megabytes, gigabytes, and terabytes, respectively).

📘

Known limitation

This command is only applicable to Intel images.

For more information, see Apple Silicon-Based Support.

📘

Orka lists an unexpected size?

If you run orka image list, Orka lists generated empty storage disks with a fixed size of ~192k. When attached to a VM and formatted, the disk will appear with its correct size in the VM.

orka image generate

OR

orka image generate --image <NAME.img> -q <SIZE> -y

Output

Options

You can pass the following options with orka image generate in direct mode:

Copy image

Command

Create a copy of an existing base image . The base image must be available in your local Orka storage.

orka image copy

OR

orka image copy --image <IMAGE> -o <NEW_IMAGE_NAME> -y

Output

Options

You can pass the following options with orka image copy in direct mode:

Rename an image

Command

Rename the specified base image. The image must be stored in your local Orka storage.

orka image rename

OR

orka image rename --image <IMAGE> -o <NEW_IMAGE_NAME> -y

Output

Options

Delete an image

Command

Delete the specified base image from your local Orka storage. Make sure that the image is not in use.

orka image delete

OR

orka image delete --image <IMAGE> -y

Output

Options

You can pass the following options with orka image delete in direct mode:

Create a new base image from a deployed VM

Command

Save the current disk of a deployed VM as a new base image. This does not affect the original base image of the VM.

orka image save

OR

orka image save -v <VM_ID> -b <NEW_IMAGE_NAME> -y

Output

Options

You can pass the following options with orka image save in direct mode:

Update an existing base image by committing changes to it

Command

Take the changes from the specified deployed VM and commit them back to its respective base image. The base image must not be in use by any other VMs.

orka image commit

OR

orka image commit -v <VM_ID> -y

Output

Options

You can pass the following option with orka image commit in direct mode:

Resize an image

Command

Resize the current disk of a deployed VM and save it as a new base image. This does not affect the original base image of the VM.

orka image resize

OR (resize image and save a new base image)

orka image resize -v <VM_ID> -q <NEW_SIZE> --vm-username <VM_USERNAME> --vm-password <VM_PASSWORD> -o <NEW_IMAGE_NAME> -y 

OR (resize image and save a new base image manually)

orka image resize -v <VM_ID> -q <NEW_SIZE> --vm-username <VM_USERNAME> --vm-password <VM_PASSWORD> -y

OR (resize image and perform the partition resize manually)

orka image resize -v <VM_ID> -q <NEW_SIZE> -y

Output