Service Managers (eg. systemd)

2 min

You may want to start Aerogramme automatically on boot, restart it if it crashes, etc. Such actions can be achieved through a service manager.


We make some assumptions for this systemd deployment.

  • Your garage binary is located at /usr/local/bin/aerogramme.
  • Your configuration file is located at /etc/aerogramme/config.toml.
  • If you use Aerogramme's user management, the user list is set to /etc/aerogramme/users.toml.

Create a file named /etc/systemd/system/aerogramme.service:

Description=Aerogramme Email Server

Environment='RUST_LOG=aerogramme=info' 'RUST_BACKTRACE=1'
ExecStart=/usr/local/bin/aerogramme -c /etc/aerogramme/config.toml provider daemon


A note on hardening: The Aerogramme daemon is not expected to write on the filesystem. When you use the aerogramme provider account, the write is done by your current user/process, not the daemon process. That's why we don't define a StateDirectory.

To start the service then automatically enable it at boot:

sudo systemctl start aerogramme
sudo systemctl enable aerogramme

To see if the service is running and to browse its logs:

sudo systemctl status aerogramme
sudo journalctl -u aerogramme

To add a new user:

sudo aerogramme \
  -c /etc/aerogramme/config.toml \
  provider account add --login alice --setup #...

sudo systemctl reload aerogramme

Other service managers

Other service managers exists: SMF (illumos / solaris), OpenRC (alpine & co), rc (FreeBSD, OpenBSD, NetBSD). Feel free to open a PR to add some documentation. You would not use System V initialization scripts...