install-mh - Man Page

initialize the nmh environment


/usr/libexec/nmh/install-mh [-help] [-version] [-auto] [-check]


install-mh creates the initial setup for a first-time nmh user. install-mh is installed in two locations for historical reasons.

The -auto switch does things as automatically as possible and makes install-mh less chatty.

The user is prompted for the name of the directory to be designated as the user's nmh directory.  If this directory does not exist, the user is asked if it should be created.  Normally, this directory should be under the user's home directory, and has the default name of `Mail'. install-mh writes an initial .mh_profile for the user.

As with all nmh commands, install-mh first checks for the existence of the $MH environment variable, since that, if set, gives the profile path. If it isn't set, the $HOME environment variable is consulted to determine the user's home directory. If $HOME is not set, then the /etc/passwd file is consulted.

When creating the user's .mh_profile, install-mh will check for the existence of a global profile at /etc/nmh/mh.profile. If found, this will be used to initialize the new .mh_profile.

The -check switch checks if nmh is installed. (This can be used by other programs to determine if nmh has been installed.)

install-mh sets up the user's profile to support the mh-draft(5) draft folder facility.



The user's profile.


Used to initialize user's profile.

Profile Components


To set the user's nmh directory.

See Also



With -auto, the current folder is changed to “inbox”.

Referenced By


2022-12-22 nmh-1.8