Skip to main content
Marchyo manages user accounts through the marchyo.users option. Each user gets a system account with associated metadata used by git, applications, and Home Manager.

​
Basic usage

marchyo.users.myuser = {
  fullname = "Your Name";
  email = "your@email.com";
};
This creates a user account named myuser with the provided name and email configured across git and other applications.

​
Options

OptionTypeDefaultDescription
marchyo.users.<name>.enablebooltrueWhether to apply Marchyo configuration to this user
marchyo.users.<name>.fullnamestring—Full name (used in git config and applications)
marchyo.users.<name>.emailstring—Email address (used in git config and applications)
marchyo.users.<name>.uidint or nullnullNumeric user id. On NixOS sets users.users.<name>.uid; on macOS opts the user into declarative login-shell management (see below)

​
Login shell

Bash (5.x, bashInteractive) is the Marchyo default login shell on every platform. On NixOS this is set via users.defaultUserShell (overridable with your own value). On macOS (nix-darwin), changing an account’s shell requires the user to be listed in users.knownUsers with the account’s exact uid — a mismatch aborts activation, so Marchyo does not guess. Provide the uid to opt in (the first macOS user is 501): 
marchyo.users.myuser = {
  fullname = "Your Name";
  email = "your@email.com";
  uid = 501; # check with: id -u
};
With the uid set, nix-darwin switches the login shell to bash declaratively. Without it, bash is still registered in /etc/shells, so you can switch once manually: 
chsh -s /run/current-system/sw/bin/bash

​
Multiple users

You can define multiple users: 
marchyo.users = {
  alice = {
    fullname = "Alice Smith";
    email = "alice@example.com";
  };
  bob = {
    fullname = "Bob Jones";
    email = "bob@example.com";
  };
};

​
Disabling a user

To keep a user definition but exclude it from Marchyo configuration: 
marchyo.users.myuser = {
  enable = false;
  fullname = "Your Name";
  email = "your@email.com";
};
Last modified on July 9, 2026