Skip to content

Public inbox

services.public-inbox.enable

Whether to enable the public-inbox mail archiver. Type: boolean

Default

false

Example

true

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.http.args

Command-line arguments to pass to {manpage}public-inbox-httpd(1). Type: list of string

Default

[ ]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.http.enable

Whether to enable the public-inbox HTTP server. Type: boolean

Default

false

Example

true

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.http.mounts

Root paths or URLs that public-inbox will be served on. If domain parts are present, only requests to those domains will be accepted.

Type: list of string

Default

["/"]

Example

["/lists/archives"]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.http.port

Listening port or systemd's ListenStream= entry to be used as a reverse proxy, eg. in nginx: locations."/inbox".proxyPass = "http://unix:${config.services.public-inbox.http.port}:/inbox"; Set to null and use systemd.sockets.public-inbox-httpd.listenStreams if you need a more advanced listening.

Type: null or string or 16 bit unsigned integer; between 0 and 65535 (both inclusive)

Default

80

Example

"/run/public-inbox-httpd.sock"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.imap.args

Command-line arguments to pass to {manpage}public-inbox-imapd(1). Type: list of string

Default

[ ]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.imap.cert

Path to TLS certificate to use for connections to {manpage}public-inbox-imapd(1). Type: null or string

Default

null

Example

"/path/to/fullchain.pem"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.imap.enable

Whether to enable the public-inbox IMAP server. Type: boolean

Default

false

Example

true

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.imap.key

Path to TLS key to use for connections to {manpage}public-inbox-imapd(1). Type: null or string

Default

null

Example

"/path/to/key.pem"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.imap.port

Listening port. Beware that public-inbox uses well-known ports number to decide whether to enable TLS or not. Set to null and use systemd.sockets.public-inbox-imapd.listenStreams if you need a more advanced listening.

Type: null or string or 16 bit unsigned integer; between 0 and 65535 (both inclusive)

Default

993

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.inboxes

Inboxes to configure, where attribute names are inbox names.

Type: attribute set of (attribute set of (INI atom (null, bool, int, float or string) or a list of them for duplicate keys))

Default

{ }

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.inboxes.<name>.address

The email addresses of the public-inbox. Type: list of string

Example

"example-discuss@example.org"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.inboxes.<name>.coderepo

Nicknames of a 'coderepo' section associated with the inbox. Type: list of coderepo names

Default

[ ]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.inboxes.<name>.description

User-visible description for the repository. Type: string

Example

"user/dev discussion of public-inbox itself"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.inboxes.<name>.inboxdir

The absolute path to the directory which hosts the public-inbox. Type: string

Default

"/var/lib/public-inbox/inboxes/‹name›"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.inboxes.<name>.newsgroup

NNTP group name for the inbox. Type: null or string

Default

null

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.inboxes.<name>.url

URL where this inbox can be accessed over HTTP. Type: non-empty string

Example

"https://example.org/lists/example-discuss"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.inboxes.<name>.watch

Paths for {manpage}public-inbox-watch(1) to monitor for new mail. Type: list of string

Default

[ ]

Example

["maildir:/path/to/test.example.com.git"]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.inboxes.<name>.watchheader

If specified, {manpage}public-inbox-watch(1) will only process mail containing a matching header.

Type: null or string

Default

null

Example

"List-Id:<test@example.com>"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.mda.args

Command-line arguments to pass to {manpage}public-inbox-mda(1). Type: list of string

Default

[ ]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.mda.enable

Whether to enable the public-inbox Mail Delivery Agent. Type: boolean

Default

false

Example

true

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.nntp.args

Command-line arguments to pass to {manpage}public-inbox-nntpd(1). Type: list of string

Default

[ ]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.nntp.cert

Path to TLS certificate to use for connections to {manpage}public-inbox-nntpd(1). Type: null or string

Default

null

Example

"/path/to/fullchain.pem"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.nntp.enable

Whether to enable the public-inbox NNTP server. Type: boolean

Default

false

Example

true

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.nntp.key

Path to TLS key to use for connections to {manpage}public-inbox-nntpd(1). Type: null or string

Default

null

Example

"/path/to/key.pem"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.nntp.port

Listening port. Beware that public-inbox uses well-known ports number to decide whether to enable TLS or not. Set to null and use systemd.sockets.public-inbox-nntpd.listenStreams if you need a more advanced listening.

Type: null or string or 16 bit unsigned integer; between 0 and 65535 (both inclusive)

Default

563

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.openFirewall

Whether to enable opening the firewall when using a port option. Type: boolean

Default

false

Example

true

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.package

The public-inbox package to use. Type: package

Default

pkgs.public-inbox

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.path

Additional packages to place in the path of public-inbox-mda, public-inbox-watch, etc.

Type: list of package

Default

[ ]

Example

with pkgs; [ spamassassin ]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.postfix.enable

Whether to enable the integration into Postfix. Type: boolean

Default

false

Example

true

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.settings

Settings for the public-inbox config file.

Type: attribute set of attribute set of ((INI atom (null, bool, int, float or string) or a list of them for duplicate keys) or attribute set of (INI atom (null, bool, int, float or string) or a list of them for duplicate keys))

Default

{ }

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.settings.coderepo

code repositories Type: attribute set of (attribute set of (INI atom (null, bool, int, float or string) or a list of them for duplicate keys))

Default

{ }

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.settings.coderepo.<name>.cgitUrl

URL of a cgit instance Type: string

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.settings.coderepo.<name>.dir

Path to a git repository Type: string

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.settings.publicinbox

public inboxes Type: attribute set of ((INI atom (null, bool, int, float or string) or a list of them for duplicate keys) or attribute set of (INI atom (null, bool, int, float or string) or a list of them for duplicate keys))

Default

{ }

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.settings.publicinbox.css

The local path name of a CSS file for the PSGI web interface. Type: list of string

Default

[ ]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.settings.publicinbox.imapserver

IMAP URLs to this public-inbox instance Type: list of string

Default

[ ]

Example

["imap.public-inbox.org"]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.settings.publicinbox.nntpserver

NNTP URLs to this public-inbox instance Type: list of string

Default

[ ]

Example

["nntp://news.public-inbox.org""nntps://news.public-inbox.org"]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.settings.publicinbox.pop3server

POP3 URLs to this public-inbox instance Type: list of string

Default

[ ]

Example

["pop.public-inbox.org"]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.settings.publicinbox.wwwlisting

Controls which lists (if any) are listed for when the root public-inbox URL is accessed over HTTP.

Type: one of "all", "404", "match=domain"

Default

"404"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.settings.publicinboxmda.spamcheck

If set to spamc, {manpage}public-inbox-watch(1) will filter spam using SpamAssassin.

Type: one of "spamc", "none"

Default

"none"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.settings.publicinboxwatch.spamcheck

If set to spamc, {manpage}public-inbox-watch(1) will filter spam using SpamAssassin.

Type: one of "spamc", "none"

Default

"none"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.settings.publicinboxwatch.watchspam

If set, mail in this maildir will be trained as spam and deleted from all watched inboxes

Type: null or string

Default

null

Example

"maildir:/path/to/spam"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix

services.public-inbox.spamAssassinRules

SpamAssassin configuration specific to public-inbox. Type: null or path

Default

${cfg.package.sa_config}/user/.spamassassin/user_prefs

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/mail/public-inbox.nix