Skip to content

Stela v0.1.0

Choose a tag to compare

@github-actions github-actions released this 11 Nov 06:37
· 1548 commits to main since this release

Install

Download the archive for your system, unpack it and plug in the USB stick. Then make the stick, on the PC that will run macOS (this erases the stick):

sudo ./stela setup

On Windows, open Terminal with Run as administrator and write .\stela.exe in place of sudo ./stela.

Then boot the PC from the stick.

What works

This is the first release.

Running macOS

  • Stela boots unmodified macOS 27 for Apple silicon on an x86-64 PC. It presents a Mac mini (M2).
  • A translator turns arm64e code into x86-64 code, ahead of time and while it runs. It covers more than 3,000 AArch64 instruction encodings and caches translated code.
  • A Metal driver for NVIDIA GPUs compiles Metal shaders for the GPU. It supports the Metal3 and Apple7 GPU families.
  • macOS and most apps start.

Setup

  • One stela program for Linux, Windows and macOS makes the USB stick, step by step.
  • Setup downloads macOS from Apple, or uses an IPSW file you already have.
  • The installer on the stick lets you choose the disk and the space for macOS. It can use free space, delete a partition or erase a disk. It writes nothing until you confirm.
  • The network during the install can be Ethernet or Wi-Fi, with DHCP or fixed addresses (--ipv4, --ipv4-gateway, --dns).
  • Maintenance commands work on an existing stick: status, repair, update, configure, uninstall, boot-log, and backup and restore of the machine state.

Hardware support

  • Ethernet: Intel I225, I226, I210, I211, I350 and 82574L; Realtek; Broadcom BCM5720, BCM5761 and BCM5762; Aquantia AQtion.
  • Wi-Fi: Intel, MediaTek and Realtek RTL8822C adapters.
  • Disks: NVMe and SATA (AHCI).

Boot log

If Stela does not work, save the boot log and include log.txt in your report:

sudo ./stela setup boot-log --usb /media/$USER/STELA > log.txt