NGIpkgs

Nix is an open source build system, configuration management system, and mechanism for deploying software, focused on reproducibility. It is the basis of an ecosystem of exceptionally powerful tools. Nixpkgs is the largest, most up-to-date software repository in the world. NixOS is a Linux distribution that can be configured fully declaratively, with unmatched flexibility.

This repository makes software projects which are funded by the Next Generation Internet (NGI) initiative of the European Commission through the NLnet Foundation available as

• Configuration modules compatible with NixOS
• Package recipes compatible with Nixpkgs

and provides automatically tested example NixOS configurations.

Tip

View NGI software packaged for NixOS on https://ngi.nixos.org.

NGIpkgs was created as part of Summer of Nix, organised by the NixOS Foundation.

How to use software from NGIpkgs

This is what you can do with software from NGIpkgs:

• Run standalone programs locally with Nix
• Use libraries or tools to build software with Nixpkgs
• Deploy services to machines running NixOS

In order to do that:

• Install Nix on Linux or WSL

Warning

End-user instructions are not available yet, and even simple workflows may not work as intended. This is currently work in progress.

You need to be proficient enough with the Nix langauge and NixOS to read the code and set up an environment where you can experiment with deploying and running the applications provided in this repository.

It will help you to go more quickly if you learn to:

• Read the Nix language
• Package existing software with Nixpkgs
• Work with NixOS modules
• Run NixOS in virtual machines
• Provision remote NixOS machines via SSH
• Set up your own cache for sharing binaries

Structure of NGIpkgs

The each piece of software in NGIpkgs is called a project. Each project may consist of multiple packaging artefacts:

• NixOS configuration modules for adding application components to a NixOS system
• Exampes for configuring these modules
• Tests to ensure the modules and examples work as intended
• Libraries for various progrmaming languages that can be composed with Nixpkgs package recipes
• Links to upstream documentation for using the application or maintaing or extending the NixOS packaging

.
├── README.md            # this file
├── default.nix          # collection of project configuration modules (and some helper tooling)
├── projects
│   ├── default.nix      # aggregates all projects
│   ├── models.nix       # data model for packaging artefacts
│   ├── <project-name>
│   │   ├── default.nix  # packaging artefacts for a project
│   …   └── …            # other files for implementing a project package
├── pkgs
│   └── by-name
│       └── …            # directories with Nixpkgs-compatible package recipes
├── flake.nix            # CI setup
└── …

NixOS modules can be integrated into a NixOS configuration. Many of them expose options for configuring one or more systemd services that are designed to run on NixOS. These modules are ready to be deployed to a NixOS system running in a container, virtual machine, or on a physical machine.

Example configurations found in the corresponding per-project directory are a good starting point for anyone interested in using these modules, and can be expected to work because they are automatically tested in continuous integration.

Nixpkgs-style package recipes can in principle be built on any operating system supported by Nix. The output of building such a recipe is often a library or executable, including its dependencies. In NGIpkgs, these recipes are maintained in the pkgs directory.

Corresponding to projects funded by NGI through NLnet there are per-project subdirectories within the projects directory. Each of these sub-directories contain a default.nix which

• Picks packages associated with the project from those defined in pkgs and Nixpkgs,
• Exposes NixOS modules, tests, and configurations which are also maintained in the per-project directory,
• May contain additional metadata about the project
• Follows the data model for packaging artefacts

Continuous builds of packages with Buildbot

All packages in the main branch of NGIpkgs are automatically built by a Buildbot server. The results of these builds can be found at https://buildbot.ngi.nixos.org/#/projects/1

Reasoning for creation of the NGIpkgs monorepo

• Users can discover NGI projects on an overview page and use them immediately.
• Many software packages are research projects that would not (yet) make sense to distribute through Nixpkgs or NixOS.
• The funding organisations get an overview of the packaging situation.
• Maintainers of the NGI software collection can experiment with code architecture and user experience without interfering with upstream NixOS development or having to deal with stricter stability requirements.

Our intention is to eventually bring innovations to Nixpkgs and NixOS once they are proven to work well and there is a realistic migration path that won't break upstream contributors' and users' workflows.

Contributing to NGIpkgs

Please see CONTRIBUTING.md

Acknowledgements

NGIpkgs is funded by the European Commission's Next Generation Internet (NGI) initiative through the NLNet Foundation and the NixOS Foundation.