GitHub - numtide/system-manager: Manage system config using nix on any distro


Thanks to the authors for making this. The first steps toward something that has been a much requested feature.



Wow this looks amazing! I am specifically interested regarding the --target-host option:

systems-manager --help
System Manager -- Manage system configuration with Nix on any distro

Usage: system-manager [OPTIONS] <COMMAND>

          Activate a given system-manager profile
          Build a new system-manager profile without registering it as a nix profile
          Deactivate the active system-manager profile, removing all managed configuration
          Generate a new system-manager profile and register is as the active system-manager profile
          Generate a new system-manager profile and activate it
          Print this message or the help of the given subcommand(s)

      --target-host <TARGET_HOST>
          The host to deploy the system-manager profile to

          Invoke the remote command with sudo. Only useful in combination with --target-host

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version

How does this work exactly? Does it rely upon a Nix daemon running on the target host? Or does it just ssh to it and replaces the /etc/ directory there with the one generated by system-manager? Does it take care of garbage collection as well? I’m asking because I wonder if it’s possible to use this tool to replace my imperative Arch Linux VPS installation with a declarative one of Nix, when the VPS has very low disk space and thus can’t use Nix natively.

P.S It would be nice to put the --help text in the repo’s README :).

1 Like

The Nix-Darwin of foreign Linux! And just maybe, an early ancestor of the future GRUMS. Love to see it. Thanks for posting it here!!


We started writing this because some of our customers want to benefit from the NixOS experience, but switching entirely to NixOS is too much to ask. This is a big project, so we have to pace ourselves.

We currently have a working POC that manages systemd units and /etc/files using the Nix module system, tested on Ubuntu. The main logic is all written in Rust and introduces a local state file, making it possible to remove everything cleanly. Note that things are very early so there is no documentation, and things might break.

In the near future, we want to:

  • add support for tmpfiles.d
  • handle service users
  • support the most common NixOS services
  • support more Linux distributions
  • write documentation and user guides.

If you want to help out, feel free to try it and report issues. If your company could benefit from such work, we are also interested in getting in contact to specifically support your use cases.


We’ve been doing really dirty things to mimic something like this. We’ve built nixos on the systems and had Saltstack link things from the result into the normal system.

I’ve been waiting for this since forever, great job! :slight_smile:


Nice! This looks really useful :+1:

Hard to predict the future, but is there an incentive to combine with NixOS modules so that modules can be used by both system-manager as well as NixOS.


For now we assume that the target machine already has Nix installed. We could include a bootstrap method in the future. Just like NixOS, the system closure can be built locally, then copied using nix copy, and bound to a profile in /nix/var/nix/profiles/. Except that it’s named system-manager instead of system. The biggest difference is that unlike NixOS where you can have a single /run/current-system symlink, we have to carefully weave the symlinks into the /etc folder to not disrupt the current distribution. That’s where the diffing engine and state file come in play. The exact implementation details of that diffing engine will probably change as we extend the scope of the project.

One of the goals that we have is that modules written in system-manager should be compatible with NixOS. That way, system-manager can become an on-ramp to NixOS whenever they are ready to do the full switch.

The reverse is more difficult because the namespace of NixOS is very wide. Any module might set values to any other modules. What I envision is that the list of NixOS modules that work out of the box will grow, depending on the customers or contributions that we get. Probably the most interesting ones are networked services such as nginx and postgres.


A module like this one (salt-master) looks like it’d be compatible with system-manager.

If the idea isn’t to be compatible with NixOS modules, would you accept modules that are just straight up ports from NixOS modules?

My thought when implementing my shabby version of this was to build the entirety of NixOS, then have some custom module that’d link from /run/current-system/etc/$name to /etc/$name, essentially a way to write nix to “include” files that should be linked, and keep state of the difference.

This looks more robust, but re-implementing NixOS modules is a lot of work.

The idea is that system-manager itself only ships with the core modules like, environment.etc, … Those are re-implemented in Rust, with a diffing engine; a bit like Terraform but for local system changes.

Then as a user, you would use imports = [ "${modulesPath}/path/to/my/service.nix" ]; to load whatever service from the NixOS distribution, and if you are lucky, it’s compatible :slight_smile: Of course, a lot of modules will break initially, but we can expand the surface area over time. Common services such as Nginx would also be part of our test suite to avoid regressions.

Anyways, that’s the idea for now. This is still pretty early so some of those ideas might change as we learn more about the domain.

Hosted by Flying Circus.