refactor: simplify attrs flattening (#379)
flake.lock: Update (#377)
Document how to deploy NGIpkgs services (#369)
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.
Many software projects funded by the Next Generation Internet (NGI) initiative of the European Commission through the NLnet Foundation are not mature enough to distribute through Nixpkgs, or cannot be included in Nixpkgs for technical reasons. This repository makes such projects available as
and provides automatically tested example NixOS configurations.
NGIpkgs was created as part of Summer of Nix, organised by the NixOS Foundation.
This is what you can do with software from NGIpkgs:
In order to do that:
It will help you to go more quickly if you learn to:
The software in NGIpkgs can be divided into two broad categories: Nix packages, and NixOS modules.
.
├── flake.nix
├── pkgs
│ └── by-name
│ └── … # directories of packages
├── projects
│ ├── <project-name> # names matching those at https://nlnet.nl/project
│ │ ├── default.nix # project definition
│ │ └── … # files of the project (e.g. NixOS module, configuration, tests, etc.)
│ └── default.nix # imports all projects
├── README.md # this file
└── …
Nix packages can theoretically be built and run on any operating system that runs Nix.
The output of building a Nix package is often a library or executable, including its dependencies.
In NGIpkgs, these packages are all contained in the pkgs
directory.
For simple package definitions, we use pkgs/by-name/<pname>/package.nix
, inspired by Nix RFC 140.
Corresponding to projects funded by NGI through NLnet there are per-project subdirectories within the projects
directory.
These per-project directories contain a default.nix
which
pkgs
and Nixpkgs,NixOS modules are components that can be easily integrated into a NixOS configuration. Many of them represent services that map to one or more systemd services that are designed to run on NixOS. These modules are ready to be deployed to a NixOS system, such as a container, virtual machine, or physical machine. Example configurations found in the corresponding per-project directory are a good starting point for anyone interested in using these modules, and are sure to work because they are also used for testing.
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
Please see CONTRIBUTING.md