debops.nixos

NixOS is a Linux-based operating system which uses a functional programming language, Nix, to control the state of the whole system. NixOS is built from the ground up on an idea of configuration management being the only method to configure the system. It's an alternative to Ansible and allows for unique capabilities like whole-system rollbacks, immutability, ability to install multiple versions of a given software side by side, and other functionality not available or hard to achieve on traditional Linux distributions.

The debops.nixos role can be used to distribute Nix configuration files to NixOS-based remote hosts using Ansible. This provides an alternative method of managing multiple NixOS hosts and allows easy integration with Debian/Ubuntu hosts managed by Ansible and/or DebOps.

• Getting started
  • Why...?
  • NixOS requirements
  • Different ways to configure NixOS
  • Example inventory
  • Example playbook
  • Ansible tags
  • Other resources
• debops.nixos default variables
  • Role configuration
  • Manage NixOS configuration via git
  • NixOS configuration files
  • Manage custom templates
• Default variable details
  • nixos__repositories
  • nixos__configuration
  • nixos__templates

Copyright

debops.nixos - Manage NixOS system configuration using Ansible

Copyright (C) 2024 Maciej Delmanowski <drybjed@gmail.com>
Copyright (C) 2024 DebOps <https://debops.org/>
SPDX-License-Identifier: GPL-3.0-or-later

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License version 3, as
published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see https://www.gnu.org/licenses/