nixos-apple-silicon: NixOS on Apple Silicon bare metal

What nixos-apple-silicon adds to bare metal NixOS

nixos-apple-silicon exists to make NixOS usable on bare metal Apple Silicon Macs. Its scope is narrower than a general NixOS installer: the repository contains package expressions and NixOS configuration modules intended to create a useful, direct installation without presenting the Mac as an ordinary Intel-based PC. After installation and activation of the Apple Silicon configuration module, the README says the system can be configured and operated like other NixOS systems.

The intended audience is therefore narrow: users who want NixOS itself as the installed operating system on supported Apple Silicon hardware, rather than developers merely looking for Apple Silicon packages while running another Linux distribution or macOS environment. The project also suits engineers who understand declarative NixOS configuration and can follow a hardware-specific setup guide.

Compatibility is a design constraint, not an incidental detail. The maintainers aim to reproduce the experience and software versions supplied by the Asahi Linux reference distribution. They accept contributions that improve the NixOS experience or address specific issues, but explicitly reject configuration and versions that diverge significantly from that reference. This is a meaningful restriction. A configuration that works elsewhere in NixOS should not be assumed to work unchanged here.

The Apple Silicon hardware stack behind NixOS

Based on the repository README, this project does not create all Apple Silicon support in isolation. Its implementation depends on major components developed elsewhere. Asahi Linux's m1n1 supplies the bootloader and hypervisor layer, while Asahi Linux's Linux fork supplies the relevant kernel work. Mark Kettenis' U-Boot port provides another part of the boot path, and Alyssa Rosenzweig's Mesa work provides the GPU driver.

That division explains the repository's stated dependence on Asahi Linux. Nix expressions and NixOS modules can assemble and manage a system, but they cannot remove the need for compatible firmware, boot stages, kernel support, and graphics components underneath it. The README credits these projects as important parts of the Apple Silicon experience rather than presenting nixos-apple-silicon as a self-contained hardware enablement suite.

For adopters, this architecture means that NixOS configuration and upstream hardware work must be considered together. A change in Nix package versions is only one part of the system. Kernel, bootloader, U-Boot, and GPU driver compatibility also matter. However, the available documentation excerpt does not name specific supported Mac models, kernel versions, or hardware requirements. Those points cannot be inferred from the package names or repository layout and need confirmation in the linked setup guide.

Repository boundaries for packages, modules, and installation images

The repository layout separates NixOS integration from build and image concerns. The `apple-silicon-support/` directory is the principal project-specific area for support packages and configuration modules. The root `default.nix` and `flake.nix` expose the Nix build interface, while `flake.lock` records the locked dependency state. The `iso-configuration/` directory contains configuration associated with an ISO. The root `.envrc` is consistent with using a Nix-aware development environment, although the README excerpt does not provide commands for entering it.

This separation suggests a useful path from source to system configuration, but the excerpt does not document the exact evaluation commands or module import layout. It would therefore be speculative to provide a command for building an installer, generating an ISO, or importing the module. Those instructions belong to the linked guide and repository files rather than the short README.

The project can still be evaluated at the repository level. A prospective user can determine whether the expected top-level Nix entry points, hardware support expressions, and ISO configuration exist. They cannot confirm from the excerpt alone which derivation produces the preferred installation image or whether a prebuilt image is available. The README points to `docs/binary-cache.md`, which may answer build and binary availability questions, but its contents are not reproduced here.

Starting with the documented Apple Silicon installation path

The README directs new users to the `docs/uefi-standalone.md` guide, titled "Setup, Installation, and Maintenance Guide (2025-11-18)", rather than publishing the full installation procedure in its opening section. The available repository information does not include the commands or configuration snippets from that guide, so supplying them would risk inventing hardware steps. Follow that document for the actual setup, installation, and maintenance sequence.

The first concrete step supported by this README is therefore to open `docs/uefi-standalone.md` and check its requirements before changing the Mac. The title identifies the path as UEFI standalone setup and dates the guide to 2025-11-18. That date matters because the repository also links release notes and a binary cache document, which should be consulted alongside the installation guide rather than treated as optional background.

After the documented installation, the README states that adding the Apple Silicon configuration module makes the system configurable and operable as NixOS. It does not provide the exact configuration expression, installer image URL, firmware invocation, partition layout, or first-boot commands. No fenced command example can be reproduced without those details. A tutorial that invents them would be particularly unsafe for bare metal installation, where boot order and media preparation are hardware-specific.

Asahi Linux alignment limits configuration freedom

The clearest trade-off is the project's policy of matching Asahi Linux. This can reduce surprises because the NixOS environment is designed around a known reference stack, including its software choices and versions. It also gives contributors a defined target instead of asking every system owner to solve Apple Silicon integration independently.

The same policy can reject changes that another NixOS user might consider reasonable. A substantially newer package, altered kernel setup, or divergent hardware configuration may not be accepted merely because it works for the contributor. The README frames such divergence as outside the project's intended contribution boundary. Users who need a custom Apple Silicon configuration should read that as a compatibility question, not merely a contribution question.

This project is also the wrong tool when the required result is macOS, a conventional Linux distribution running from Apple Silicon packages, or NixOS on non-Apple hardware. Its repository is explicitly for NixOS bare metal on Apple Silicon Macs. The excerpt does not document virtualization, live USB use, remote installation, or support for external boot media, so none should be advertised. Nor does it provide rollback instructions. The guide name includes maintenance, but the available text does not establish whether restoring the prior installation is covered.

Releases, maintenance signals, and upgrade review

The repository is not archived, and its last push was on 2026-10-12. Recent release tags include `release-2026-07-30`, `release-2025-11-18`, and `release-2025-08-23`. These dates provide concrete maintenance and upgrade signals, but they do not by themselves prove that every hardware configuration or release branch is equally supported.

The README links `docs/release-notes.md`, which is the appropriate project-specific source for checking what changed. Because the project tracks Asahi Linux and depends on components developed elsewhere, reviewing only the NixOS-facing release summary may miss an important underlying change. The excerpt does not state a fixed upgrade path, automatic migration policy, or rollback procedure, so none should be assumed.

An upgrade review should start by comparing the existing installation with the selected release's notes and the current setup guide. Then check the binary cache document to understand which artifacts are expected to come from the cache. The available text does not reproduce cache URLs or update commands. Keeping these three project documents together, `docs/release-notes.md`, `docs/binary-cache.md`, and `docs/uefi-standalone.md`, is more reliable than treating a release tag as a complete upgrade procedure.

MIT licensing and separate patch obligations

The repository identifies the MIT license for its Nix derivations and documentation. That is a favorable constraint for reading and modifying those files, subject to the terms of the license text. The repository contains a root `LICENSE` file, so users should consult that file when preparing a redistribution or derived documentation set.

The licensing boundary is narrower than it may first appear. The README explicitly says that patches included in the repository and files built by Nix are covered by separate licenses. The hardware stack also includes work credited to Asahi Linux, Mark Kettenis, and Alyssa Rosenzweig. Those projects are not automatically relicensed by nixos-apple-silicon's MIT declaration.

This matters during image distribution and compliance review. Building the NixOS system may combine repository files, patched sources, firmware-related artifacts, kernels, drivers, and packages with different licensing terms. The excerpt does not enumerate those individual terms or provide a generated third-party notice. It supports the limited conclusion that the repository's own derivations and documentation are MIT licensed while patches and built files require separate review.

Choosing between Asahi Linux and NixOS configuration

The real alternative named by the project is the Asahi Linux reference distribution. Asahi Linux provides the reference experience and the major underlying components credited in the README. It is therefore the relevant comparison for hardware behavior and software-version alignment. nixos-apple-silicon aims to reproduce that experience while presenting it through NixOS modules, Nix package expressions, and a bare metal NixOS system.

The practical difference is the operating-system and configuration model. Choosing Asahi Linux keeps the user within the reference distribution that this project follows. Choosing nixos-apple-silicon is appropriate when the user specifically wants NixOS configuration and operation on bare metal Apple Silicon hardware. The repository treats close agreement with Asahi Linux as a condition of contribution, so adopting NixOS does not create permission to ignore that baseline.

For a user deciding between them, verify which environment is the actual goal. If the deciding factor is an existing NixOS configuration, choose this project only after checking the Apple Silicon guide and its module requirements. If the deciding factor is direct alignment with the reference distribution and its current defaults, the README points users toward Asahi Linux rather than promising that nixos-apple-silicon will remove those differences.

Editorial conclusion

Adopt this project if your goal is a bare metal NixOS installation on an Apple Silicon Mac and you are comfortable staying close to the Asahi Linux reference configuration. Do not choose it for unrelated hardware, Apple macOS environments, or experimental configurations that diverge substantially from that baseline. Verify first that the 2025-11-18 setup, installation, and maintenance guide covers your Mac and that its binaries, kernel assumptions, and expected Asahi Linux versions match your plans.

Frequently asked questions

Official sources

1. Issues
2. License: MIT
3. nix-community/nixos-apple-silicon on GitHub
4. README
5. Releases