Skip to content

About

Fedora Aurora Remix: Apple Silicon RPMs, images, and signed update repository

Resources

Stars

6 stars

Watchers

0 watching

Forks

Repository files navigation

Aurora Fedora Remix

Fedora-native packaging, image builds and the signed update repository for Aurora on Apple Silicon. The native macOS application lives in aurora-installer; alarm-aurora and nixos-aurora implement the other distribution choices.

Build

All hardware sources are pinned by commit and SHA-256 in sources.json. RPM specs are under packages/; KIWI image configuration is under images/. Build a package on Fedora 44 AArch64:

sudo dnf install rpm-build dnf5-plugins python3 git
AURORA_INSTALL_BUILDDEPS=1 bash scripts/build-rpm aura

out/rpms/ contains the binary RPMs and out/srpms/ their reproducible source inputs. Kernel, bootloaders and graphics are built natively; matching kernel modules and DTBs come from the same build. AURORA_BUILD_JOBS bounds local parallelism.

The platform includes avd-fw from Aurora's firmware fork and upower from Aurora's battery-reporting fork. The latter retains Fedora's upower, upower-libs and upower-devel package names so desktop dependencies resolve normally. Its native build runs the macsmc battery-time regression tests. Firmware builds retain the linked symbols for all six decoder variants.

aurora-flatpak-gl gives Flatpak apps the same Mesa as the rest of the system. Flatpak apps load OpenGL and Vulkan from the runtime's GL extension, so without it they run Flathub's GL.default. build-extension.sh in the package directory builds org.freedesktop.Platform.GL.aurora for a runtime branch from the mesa-aurora commit into a local OSTree repository. The RPM always carries that repository, installs the extension into the system installation and sets FLATPAK_GL_DRIVERS=aurora:default:host. scripts/build-rpm aurora-flatpak-gl builds both supported branches, or accepts a prepared archive through AURORA_FLATPAK_GL_REPO_TAR. The build needs flatpak-builder, both Freedesktop SDKs and an unprivileged user with bubblewrap sandbox support; CI supplies that environment. The extension has a higher priority than GL.default and ships the same file names, so its Asahi ICD, EGL vendor file and DRI drivers replace Flathub's in the merged GL directories. Runtime branches without a GL.aurora build keep GL.default. The recipe follows the mesa-aurora commit, Version and Release like mesa-aurora-fex-guest. Both the export and RPM build validate the committed libraries, architecture, loader JSONs and embedded Mesa identity for each supported branch. A settings-only or partial repository cannot produce a successful RPM. Removing the package removes the extension, the remote and its override keys.

Updates and distribution

Fedora 45 testing describes the release-specific build and publication path. aurora-repos selects 44/testing/aarch64 or 45/testing/aarch64 through $releasever; stable remains Fedora 44 only. Upgrading from Fedora 44 to 45 covers dnf system-upgrade for installed systems.

See the release procedure for package publication, image and catalog pairing, native installer delivery, hardware qualification and snapshot restoration.

docs/updates.md covers source tracking, automatic publication, the testing and stable channels and the signing environments.

The initial update channel is testing. RPMs and repository metadata are signed with the public key in keys/; its full fingerprint is independently recorded in keys/fingerprint.txt. Private signing material is not stored in this repository. Versioned RPMs are served as immutable GitHub Release assets; static DNF metadata is served through GitHub Pages. Image and app release publication is separate from source CI and RPM candidate builds. Publication accepts successful native CI runs whose commits are merged into main, with identical package recipes, source pins, build tooling and verified output receipts. Incremental publication takes an immutable base-release, authenticates its RPMs with the committed Aurora key, replaces every output of rebuilt source packages, and requires coverage at the current recipes' source versions before signing. A partial first snapshot or stale base kernel is rejected.

Each new testing release retains repository-metadata-<tag>.tar.gz and its detached Aurora signature alongside the RPM assets. The archive preserves the signed metadata index, each checksum-verified referenced metadata file, package manifest and public key. deploy-snapshot.yml authenticates this archive and its signed index before restoring an update snapshot. The archive excludes RPM copies and has bounded, normalized paths and deterministic bytes.

An image must consume an exact tested package set. Building RPMs, resolving an image, booting it and completing a physical installation are different validation stages. Until that sequence is complete, this repository is development infrastructure rather than an installable distribution release.

aurora-firmware 44-3 applies the peripheral service preset on first installation. Image builds reject a disabled peripheral admission service. Package updates preserve an administrator's disabled or masked service settings. Existing development images containing 44-2 need sudo systemctl preset --now aurora-peripherals.service after updating to adopt the default; this command is an explicit choice to apply that preset.

aurora-firstboot 0.1.8 creates the owner with the desktop's own setup on KDE and GNOME images: the first boot asks for the disk password on the boot splash, replaces the temporary encryption key with it and destroys both copies of that key, then Plasma Setup or GNOME Initial Setup creates the account before the greeter. The minimal image keeps a full-screen text wizard, and aurora.firstboot=text on the kernel command line starts it for recovery while no owner exists. The package ships an SELinux policy module that labels Aurora's first-boot programs as ordinary executables, so systemd runs them in unconfined_service_t with SELinux enforcing; earlier images ran them in init_t, where chpasswd is denied. It also keeps GRUB's lookups on the startup disk and reapplies that after GRUB updates. Images boot with quiet loglevel=3 rd.udev.log_level=3 systemd.show_status=auto user4k=on, and image composition rejects a desktop image without its account setup.

aurora-remix-scripts 44-5 retires Plasma Setup's generated automatic login once Aurora's text wizard has created the owner.

Per-process 4K userspace pages are on by default. userpages 4k COMMAND runs a program and the programs it starts with 4K pages on the 16K kernel, for software that assumes 4K pages; everything else keeps 16K pages. The launcher is aurora-userpages, a subpackage built from the kernel-aurora source (its private prctl interface comes from that tree), and kernel-aurora requires it, so an ordinary dnf upgrade installs it. The feature needs user4k=on on the kernel command line (about 0.2% of RAM for the 4K page records, see /usr/share/doc/aurora-userpages/README.rst). Images are built with it, and on installed systems aurora-userpages adds it with grubby --update-kernel=ALL --args=user4k=on unless /etc/kernel/cmdline already sets user4k=. To turn it off, set sudo grubby --update-kernel=ALL --args=user4k=off and reboot; updates keep that choice. userpages --status shows the current process's page size and selection.

fex-emu is FEX from Aurora's fork (aurora-silicon/fex, pinned with its submodules in sources.json), built from Fedora's recipe with the same subpackages, so it replaces Fedora's build: the Aurora repository's priority=1 makes dnf install fex-emu choose Aurora's. fex stays Fedora's unrelated field-extraction tool. steam (from aurora-steam-native) installs Valve's native ARM64 client for the user on the first start and runs it in a 4 KiB page process tree through userpages. Desktop images carry gamemode and aurora-gamemode, Plasma and GNOME installs get them on upgrade through a weak dependency of aurora-platform, and steam registers each game's processes with GameMode while the game runs: games then run on the P cores of Macs with at least four, with the schedutil governor kept. To opt out, set AURORA_STEAM_GAMEMODE=0 in the environment (for example in ~/.config/environment.d/), or remove both packages with sudo dnf remove aurora-gamemode gamemode. FEX needs 4 KiB pages as well: run it from such a tree, for example userpages 4k FEXBash (/usr/share/doc/fex-emu/README.aurora). On kernels with the memory-model prctl, FEX uses hardware TSO.

Image builds run scripts/check-basics.py on the finished filesystems after finalize-image. The root is mounted read-only from root.img; the EFI files and boot.img are read as the installer writes them. The build fails unless the image has a generated UTF-8 default locale, its desktop's terminal (Ptyxis, Console or gnome-terminal; Konsole) with a launcher, GNOME's backgrounds with an existing default picture or Plasma's wallpapers, NetworkManager enabled with the desktop's network settings, logind's lid-close suspend left in place, no unit file or drop-in marked executable, and a GRUB stub that finds /boot by its UUID marker on the startup disk with hinted lookups only.

Checks

python3 -m unittest discover -s tests -p 'test_*.py'
python3 images/test_configure.py

Actions run source tests and all RPM builds on native AArch64 Fedora. The image description retains Fedora's GRUB/BLS, dracut, SELinux and first-boot setup. Aurora supplies the hardware stack and its own release identity; firmware/calibration comes from the target Mac.

Software is covered by each upstream project's license. The image base is derived from the pinned Fedora Asahi KIWI description, whose GPL license is copied into each generated description. Aurora integration scripts are MIT-licensed. Branding assets retain their original attribution.

The shared kernel enables the integrated microphone/camera/audio/haptics stack and common USB4/Thunderbolt PCIe networking, storage, USB audio and external GPU modules. Firmware for Intel Wi-Fi and AMD/Intel/NVIDIA GPUs is a hard platform dependency so minimal images do not silently omit it with weak dependencies disabled. Physical dock, storage and external GPU qualification remains pending.

SEP initialization is supplied by aurora-sep and the Aurora libfprint build. The boot timer defers probing until persistent state is available, extracts local calibration where present and verifies trusted-key sealing and unsealing. No calibration is redistributed. The full reader driver set remains enabled; the native libfprint build runs all 130 upstream/patched tests. Password policy and power-button behavior are unchanged. Real SEP hardware qualification is pending.

About

Fedora Aurora Remix: Apple Silicon RPMs, images, and signed update repository

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages