Skip to content

mobile-nixos/mobile-nixos

Repository files navigation

Mobile NixOS

Mobile NixOS is a superset on top of NixOS Linux, Nixpkgs and Nix, aiming to abstract away the differences between mobile devices.

In four words: “NixOS, on your phone”.

Read more: About Mobile NixOS.

⚠️ Note: Mobile NixOS is only expected to build succesfully against the unstable branch of Nixpkgs.

Documentation

As Mobile NixOS is a superset of NixOS Linux, the following documentation applies:

  • NixOS Manual - how to install, configure, and maintain a purely-functional Linux distribution

  • Nixpkgs Manual - contributing to Nixpkgs and using programming-language-specific Nix expressions

  • Nix Package Manager Manual - how to write Nix expressions (programs), and how to use Nix command line tools

Community

Mobile NixOS development and questions is currently hosted on the NixOS on ARM channel.

The following community resources are also available, for NixOS questions.

Other Project Repositories

  • Nix - the purely functional package manager

  • Nixpkgs - the Nix packages collection

Continuous Integration

Mobile NixOS is continuously built on the organization’s Hydra instance.

There is no published artifacts for the time being, but the documentation should point you towards resources that you can use to get started quicker when your device is supported.

Contributing

There are two ways your contributions can reach this project.

Contributions are always welcome. If it’s your first time contributing: jump in and don’t be scared. Mistakes in your first contributions are room for improvement; it is not in our nature to scold new contributors.

License

Mobile NixOS is licensed under the MIT License.

Note

As with Nixpkgs, the MIT license does not apply to the packages built, but only to the files in this repository (expressions, scripts, modules, etc.).

Patches and derivative work are covered by the licenses of their respective packages.