Skip to content

macstadium/orka-images

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Orka Images

OCI-compatible macOS VM images for use with Orka and Orka Desktop.

Using with the Orka CLI

To get started with Orka, run:

orka3 vm deploy --image ghcr.io/macstadium/orka-images/tahoe:latest

Alternatively, create a VM directly with kubectl apply or kubectl create using the following definition:

apiVersion: orka.macstadium.com/v1
kind: VirtualMachineInstance
metadata:
  name: my-orka-vm
  namespace: orka-default
spec:
  image: ghcr.io/macstadium/orka-images/tahoe:latest

Using with Orka Desktop

In Orka Desktop, click Create New VM, select Pull from Image, and enter an OCI image name:

ghcr.io/macstadium/orka-images/tahoe:latest

VM setup from IPSW script

To set up a VM from an IPSW file using Orka Desktop, see the setup.sh script.


macOS Tahoe (26.x)

Orka supports macOS Tahoe as a guest OS. Version-specific tags are available for all minor releases in the 26.x line — browse releases on Orka Hub or see all tags on GHCR.

Version support: Customers can upgrade to the latest minor release within the 26.x line without issues. Any 26.x guest image is expected to run on any supported Orka cluster, regardless of the exact minor version of the host OS.

Orka version requirement: Orka 3.5.0 or later is required to run Tahoe guest VMs.

Host OS requirement: A macOS Sequoia (15.5 or later) host is required.

Note

macOS 26.1 introduced changes to the Virtualization framework that affect certain VM functionality. Review the Apple release notes to determine if your workflows are impacted before deploying 26.1+ VMs in production.

Deploy with the CLI

orka3 vm deploy --image ghcr.io/macstadium/orka-images/tahoe:latest

To deploy a specific version, use a version-specific tag. Browse releases on Orka Hub or see all tags on GHCR.

Deploy with Orka Desktop

  1. Click + Create New VM
  2. Select Pull from OCI registry
  3. Name the VM and set parameters (CPUs, memory, disk size)
  4. In the OCI Image Name field, enter: ghcr.io/macstadium/orka-images/tahoe:latest

macOS Sequoia (15.x)

Orka supports macOS Sequoia as a guest OS. Version-specific tags are available for all minor releases in the 15.x line — browse releases on Orka Hub or see all tags on GHCR.

Deploy with the CLI

orka3 vm deploy --image ghcr.io/macstadium/orka-images/sequoia:latest

To deploy a specific version, use a version-specific tag. Browse releases on Orka Hub or see all tags on GHCR.


SIP-disabled images

SIP-disabled images are required for workflows that automate TCC permissions (for example, Citrix VDA provisioning via Ansible). Deploy with the Orka CLI using the image tags below.

macOS Sequoia

orka3 vm deploy --image ghcr.io/macstadium/orka-images/sequoia:latest-no-sip

macOS Tahoe

SIP-disabled Tahoe images are available for select versions. Browse releases on Orka Hub or see all tags on GHCR.

macOS Sonoma

orka3 vm deploy --image ghcr.io/macstadium/orka-images/sonoma:latest-no-sip

macOS Ventura

orka3 vm deploy --image ghcr.io/macstadium/orka-images/ventura:no-sip

200 GB images

Larger disk variants are available for Sequoia and Tahoe:

orka3 vm deploy --image ghcr.io/macstadium/orka-images/sequoia:200-gb
orka3 vm deploy --image ghcr.io/macstadium/orka-images/tahoe:200-gb

About

Public images for Apple silicon-based Orka virtual machines

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages