Usage

NixOS

Use manzil.nixosModules.default and declare users under manzil.users. Enabled Manzil users must also exist under users.users.

nix-darwin

Use manzil.darwinModules.default and declare users under manzil.users. Enabled Manzil users must also exist under users.users.

User configuration highlights

Common options include:

• files
• xdg.cache.files
• xdg.config.files
• xdg.data.files
• xdg.state.files
• xdg.mime-apps
• packages
• environment.sessionVariables

environment.loadEnv is generated for you, but not sourced automatically.

File contents

Managed files can be created from:

• text
• source
• generator + value

Systemd user units

On NixOS, Manzil can generate user units under ~/.config/systemd/user from the per-user systemd options. restartTriggers and reloadTriggers on generated units are respected during manifest activation, so units only bounce when their trigger payloads actually change.

Contracts

Manifest mode emits contracts.target_root and contracts.source_roots into generated manifests. The bundled linker validates those contracts both when loading the manifest and again against resolved runtime paths before applying changes.