=head1 NAME public-inbox-config - public-inbox config file description =head1 SYNOPSIS ~/.public-inbox/config =head1 DESCRIPTION The public-inbox config file is parseable by L. This is a global configuration file for mapping/discovering all public-inboxes used by a particular user. =head1 CONFIGURATION FILE =head2 EXAMPLE [publicinbox "test"] mainrepo = /home/user/path/to/test.git ; multiple addresses are supported address = test@example.com ; address = alternate@example.com url = http://example.com/test newsgroup = inbox.test =head2 VARIABLES =over 8 =item publicinbox..address The email address of the public-inbox. May be specified more than once for merging multiple mailing lists (or migrating to new addresses). This must be specified at least once, the first value will be considered the primary address for informational purposes. Default: none, required =item publicinbox..mainrepo The absolute path to the directory which hosts the public-inbox. This must be specified once. Default: none, required =item publicinbox..url The primary URL for hosting the HTTP/HTTPS archives. Additional HTTP/HTTPS URLs may be specified via C<$GIT_DIR/cloneurl> as documented in L Default: none, optional =item publicinbox..newsgroup The NNTP group name for use with L. This may be any newsgroup name with hierarchies delimited by '.'. For example, the newsgroup for L is: C Omitting this for the given inbox will prevent the group from being read by L Default: none, optional =item publicinbox..watch A location for L to watch. Currently, only C paths are supported: [publicinbox "test"] watch = maildir:/path/to/maildirs/.INBOX.test/ Default: none; only for L users =item publicinbox..watchheader [publicinbox "test"] watchheader = List-Id: Default: none; only for L users =item publicinbox..nntpmirror This may be the full NNTP URL of an independently-run mirror. For example, the https://public-inbox.org/meta/ inbox is mirrored by Gmane at C Default: none =item publicinbox..httpbackendmax If a digit, the maximum number of parallel L processes to allow for cloning this particular inbox. If an alphanumeric value starting with a lowercase alphabetic character is specified, the inbox will use a L which can be shared by multiple inboxes. Default: 32 (using a default limiter shared by all inboxes) =item publicinbox..coderepo The nickname of a "coderepo" section associated with the inbox. May be specified more than once for M:N mapping of code repos to inboxes. If enabled, diff hunk headers in patch emails will link to the line numbers of blobs. Default: none =item publicinbox..replyto May be used to control how reply instructions in the PSGI interface are displayed. ":none=dead inbox" may be specified to denote an inactive list ("dead inbox" may be replaced with another phrase). A list of comma-delimited email addresses may be specified. This can be useful for dedicated inboxes for bot emails, but discussion happens on a seperate mailing list/inbox. Mirrors of existing centralized mailing lists may use ":list" here to redirect mail only to the configured inbox address. The use of ":list" is discouraged for new mailing lists, as it leads to centralization. Default: :all =item publicinbox.css The local path name of a CSS file for the PSGI web interface. May contain the attributes "media", "title" and "href" which match the associated attributes of the HTML