Citadel and systemd
Most popular Linux/Linux operating systems have transitioned from sysvinit to systemd as the
manager of system startup scripts. Citadel transitioned to systemd in late 2019.
systemd configuration
All systemd service configuration files are located under either /lib/systemd/system
or /etc/systemd/system . You'll find the following systemd scripts installed by Citadel:
The RPMs ship the following service/configuration files:
- citadel.service - Starts the Citadel Server.
- webcit-http.service - Starts the WebCit HTTP (unencrypted) user interface.
If you need to run WebCit on a specific port or IP address, here is where you can change the command line switches to do so.
- webcit-https.service - Starts the WebCit HTTP (encrypted) user interface.
As you can see, here we are running a second instance of WebCit, on a different port number and with SSL activated.
Second instance
If for some reason you need to host multiple instances of Citadel Server on the same host, you could
make a copy of citadel.service and call it, for example, citadel-2.service, and within
the ExecStart directive specify -h/some/other/directory to run another server
with its own database. Obviously you would have to run each Citadel Server on a separate IP address to
avoid port conflicts. This method of running multiple instances of Citadel is known to work, but it is
not officially supported -- and at the end of the day you would probably be better served by running each
Citadel instance in a Docker container.
Additional resources
- systemd for Administrators:
- systemd for Administrators I
- systemd for Administrators II
- systemd for Administrators III
- systemd for Administrators IV
- systemd for Administrators V
- systemd for Administrators VI
- systemd for Administrators VII
- systemd for Administrators IX
- systemd for Administrators X
- systemd for Administrators XI
- systemd for Administrators XII
- systemd for Administrators XIII
- Man-pages:
- daemon
- systemd-exec
- system-unit
- systemd-service
- Developers:
- socket activation
- socket activation 2
There are no social media links here. Enjoy a friendly
Citadel community instead. Or go outside.