Skip to content
Questions? #nixos-aarch64 (or #nixos) on Freenode!
Nix C Ruby Shell
Branch: master
Clone or download
Latest commit 5abd837 Jan 11, 2020
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin kernel-normalize-config: don't assume -I nixpkgs Oct 2, 2019
devices Merge pull request #67 from samueldr-wip/fix/google-walleye-framebuffer Dec 28, 2019
doc doc: Document new stage-1-to-2 failure reporting Dec 3, 2019
examples/demo examples/demo: Notifications should not be focusable Dec 6, 2019
lib imageBuilder.makeMBR: Fixes bug with gap Nov 22, 2019
modules initrd-base: Use hardshutdown Jan 10, 2020
overlay hardshutdown: init at 0.0.1 Jan 10, 2020
.gitignore WIP : Builds a system image using nixos. Jun 23, 2018
LICENSE Create LICENSE May 8, 2019
README.adoc -> README.adoc Nov 16, 2019
default.nix default.nix: Allows composition Sep 25, 2019
shell.nix Added additional development tools Oct 26, 2019


Mobile NixOS

This is expected to be built against the nixos-unstable for now.

2-minutes startup

For an already bootloader-unlocked Android-based, fastboot-using device.

# Build a boot image
nix-build --argstr device $DEVICE -A

# Reboot the phone to fastboot
adb wait-for-device && adb reboot bootloader

# Use fastboot to boot the produced image
fastboot boot result

Booting qemu

The qemu target has a vm build output, which results in a script that will automatically start the "virtual device".

# Build the system
nix-build --argstr device qemu-x86_64 -A build.vm

# Run the VM, using the script


This file is used to work on producing build artifacts from the "WIP" repository checkout. This is equivalent to adding settings in configuration.nix.

If the file does not exist, it will not fail.

A sample local.nix:

{ lib, ... }:

  mobile.boot.stage-1.splash.enable = false;

This will disable splash screens.

Note that this can be set to another file with <mobile-nixos-configuration>. By setting it to the path of a nix expression, it will be used instead of using local.nix.

This is the current mechanism expected to be used to create special builds using the mobile-nixos tooling (e.g. to create a custom special boot.img).


The goal is to get a NixOS system running on mobile devices, e.g. Android phones.

This is intended as building blocks, allowing the end-users to configure their systems as desired.

The amount of targeted devices does not dilute or devalue the work. It’s the other way around, it increases the odds that people will start using the project and contribute back.

Prior work

This project initially borrowed and relied on the hard work from the PostmarketOS project. They are forever thanked in their efforts.

You can’t perform that action at this time.