Files
OrionOS/iso/mac-install-notes.md
T
nmemmertandClaude Sonnet 4.6 33c2f3b66d Fix remaining sky* references missed in Phase 7 rename
- Dockerfile: WORKDIR /skyos → /orionos, ENTRYPOINT path, image name
- Makefile: skyos-default.png → orionos-default.png in install target
- iso/build-base.sh: all sky*/SkyOS → orion*/OrionOS
- iso/mac-install-notes.md: update install instructions for OrionOS
- themes/OrionOS: finish renaming sky* strings in gtkrc, gtk.css, index.theme

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-07-23 13:45:00 -04:00

2.3 KiB
Raw Blame History

Installing OrionOS on an Intel Mac

Before you start

  • Intel Mac (any MacBook/MacBook Pro with Intel CPU — 2006–2020)
  • USB drive ≥ 4 GB
  • The OrionOS ISO

Step 1 — Boot from USB

Intel Macs use EFI + rEFInd (included in the ISO) to boot Linux.

  1. Hold Option (⌥) at startup to see the boot picker.
  2. Select the OrionOS USB drive (shows as "EFI Boot").

Step 2 — Partition the disk

In the live environment, run cfdisk /dev/sda (replace with your disk):

Partition Size Type Mount
sda1 512 MB EFI System /boot/efi
sda2 4 GB Linux swap swap
sda3 remainder Linux filesystem /

Format:

mkfs.fat -F32 /dev/sda1
mkswap /dev/sda2
mkfs.ext4 -L OrionOS /dev/sda3

Step 3 — Install

mount /dev/sda3 /mnt
mkdir -p /mnt/boot/efi
mount /dev/sda1 /mnt/boot/efi
swapon /dev/sda2

pacstrap /mnt base linux linux-firmware ...  # (handled by build-base.sh)
genfstab -U /mnt >> /mnt/etc/fstab

Step 4 — rEFInd for Mac EFI

Intel Macs need rEFInd instead of GRUB for reliable EFI booting:

arch-chroot /mnt
refind-install

rEFInd auto-detects the kernel; our config at /boot/EFI/refind/refind.conf points it at the right initramfs.

Step 5 — First boot

Log in as sky (password: orionos — change it!), then:

startx

The SkyWM desktop launches with the Deskbar in the top-right corner.

Intel Mac hardware notes

Hardware Status Notes
WiFi (Broadcom) Works broadcom-wl-dkms DKMS driver
Intel iGPU Works xf86-video-intel or modesetting
Discrete GPU Partial AMD: works; Nvidia: use nouveau
Trackpad Works xf86-input-libinput with gestures
Audio Works alsa-utils + snd_hda_intel
Suspend/Resume Mostly echo mem > /sys/power/state
Keyboard backlit Works /sys/class/leds/ brightness control
Webcam Works UVC driver built into kernel
Thunderbolt Partial TB1/2: limited; TB3+: better