citserver

Citadel server core

SYNOPSIS

citserver [-lLogFacility] [-d] [-f] [-D]  [-tTraceFile] [-x Debug Component list] [-hHomeDir]

DESCRIPTION

Citadel Server (the binary name is citserver) is the core of the Citadel Suite. It provides data storage and connection-oriented protocols such as IMAP/POP/SMTP. citserver will usualy be spawned via a system service such as systemd or sysvinit. Unless using the -h option you shouldn't run several instances at once.

OPTIONS

Switch		Result
------		------
-l		Log facility.  Usually "mail"
-d		daemonize (detach from controlling terminal)
-D		print the directories the server would access to stderr on startup
-x		debug level
-h[HomeDir]	Data directory for this Citadel installation.  If the directory name begins with
		a forward slash, it is an absolute path; otherwise it is relative to the default.  Watch the
		output of -D to observe the effects.

DEFAULTS

Default port bindings opened by citserver:

Port	Description
----	-----------
25	SMTP (MTA)
110	POP3
143	IMAP
465	SMTPS
504	Citadel protocol
587	SMTP (MSA)
993	IMAPS
995	POP3S

Unix Domain Sockets opened by citserver:

Socket name		Purpose
-----------		-------
citadel.socket		Citadel
lmtp.socket		LMTP
lmtp-unfiltered.socket	LMTP, bypassing spam filters

FILES

In a self-contained build (Easy Install, Docker, etc.) all files will be stored in the /usr/local/citadel hierarchy.

In an LHFS build (used by some package maintainers), the following directory locations apply:

/usr/share/citadel-server	Citadel's messages and help files
/var/lib/citadel		Citadel data files
/var/run/citadel		volatile files like the Unix Domain Sockets
/etc/citadel			Citadel configuration files
/etc/init.d/citadel		init script for CitServer; add reboot-safe parameters here.
/etc/default/citadel		Options to /etc/init.d/citadel in LHFS installations

HISTORY

1987 - Now the Uncensored Communications Group