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)

​
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 April 8, 2026