Repository navigation
Stela v0.3.0
Install
Download the archive for your system, unpack it and plug in the USB stick. Then run one of these in the unpacked folder.
Make a new stick (this erases it):
sudo ./stela setup
Update an existing Stela stick to v0.3.0:
sudo ./stela setup update stela
On Windows, open Terminal with Run as administrator and write .\stela.exe in place of sudo ./stela.
Then boot the PC from the stick.
Changes
Setup and updates
- Setup asks for the installer again: Offline or Online. Offline is the default on a stick of 32 GB or more. Scripts use
--installer offlineor--installer online. - Every stick now carries the firmware for every supported device. You can make the stick on any computer, not only on the PC that will run macOS.
status,repairandupdatefind the stick by themselves when only one disk holds a Stela setup.--usbis needed only when there are several.update stelaupdates sticks made with v0.1.0 and v0.2.0. When it needs new boot files, it takes them from a macOS image already on the computer or from the stick's own copy of macOS. Otherwise it downloads only the boot files, about 2.2 GB instead of the whole image.- An interrupted setup can be resumed. Setup offers to resume it, keeps every intact piece and downloads only what is missing or damaged.
- Setup uses a macOS image already on the computer instead of downloading it again.
- Every command checks free space, rights and what it must download before it changes anything.
update oson a stick with room for only one copy of macOS asks before it replaces the old copy.- Setup reads the stick back from the disk after writing, so the check sees what is really on the stick.
- Firmware downloads try git.kernel.org first and GitLab second, and name the error when both fail.
- On Windows, a command that writes disks stops at once when it does not run as administrator.
- Under
sudo, the download cache stays owned by your user. - Errors from Apple's signing service are described in plain words.
Install
- The install screen says whether it installs offline or asks Apple over the network.
- An Offline install checks the signing answers on the stick before it changes any disk. If they do not fit and there is no network, it stops with the disk untouched.
- A failed signing request is retried up to five times.
- A slow download during an Online install no longer causes a macOS watchdog panic.
- The disk picker refuses a disk Stela cannot drive before you choose it, and names RAID mode when that is the cause.
- The disk picker reads SATA disk serial numbers correctly.
- A disk chosen earlier that was wiped or repartitioned is treated as not chosen, instead of stopping the boot. A new startup choice installs macOS on another disk.
Boot logs and errors
stela setup boot-logwithout--usbreads every disk of the computer.--output FILEwrites the logs to a file.- The USB boot log is written from before the GPU starts, so a stop during GPU start is kept.
- The boot log lists every PCI device and the driver Stela gives it.
- A failed NVIDIA GPU start names the GPU, its chip and the failed step. Display adapters that Stela does not use are named on screen.
- A macOS panic now shows its message instead of ending in a silent watchdog reset.
- A device that does not start within 30 seconds is skipped, and the boot goes on.
Graphics
- GTX 16 to RTX 40 series GPUs wait for their firmware after a reset, which fixes some failed GPU starts.
- Compiled Metal pipelines are kept in a crash-safe store, so power loss and panics no longer lose them.
- A missing Metal plugin is repaired by one automatic restart, instead of stopping the boot.
- A finished GPU job no longer wakes every Metal app.
- Shader compiles no longer run inside an app's GPU call.
Performance
- macOS gets more of the PC's memory: about 2.7 GiB more on a PC with 32 GB.
- Many more floating-point and half-precision instructions run as native x86 code instead of a slow path.
- Translated code keeps vector registers in host registers, and uses AVX2 where the CPU has it.
- System calls, returns, timers and performance counters run natively in more cases.
- On CPUs that support it, waiting cores halt at once instead of spinning first.
- The translation cache drops code that no boot used for three boots in a row.
- Ethernet drivers receive packets with less copying.
Hardware support
- Ethernet: Qualcomm Atheros AR8131, AR8132, AR8151 and AR8152.
- Ethernet: Realtek RTL8111H works. A Realtek adapter that ran out of receive buffers now recovers.
- PCs whose firmware marks PCI configuration space as runtime memory are accepted.
- USB devices that connect late are found: the boot waits up to 25 seconds for a needed disk.
Fixes
- macOS keeps the correct time across restarts.
- macOS no longer panics when it writes to a cloned file.
- A warm restart no longer leaves old memory behind that made the GPU setup panic.
- A page-table bug in the NVIDIA driver's GPU memory handling is fixed.
Boot log
If Stela does not work, save the boot log and include log.txt in your report:
sudo ./stela setup boot-log --output log.txt