rsyslog/rsyslog-minimal repository overview

⁠rsyslog/rsyslog-minimal

rsyslog/rsyslog-minimal is a lean Ubuntu-based image that provides the rsyslog core with a very small default configuration.

⁠What it is for

Use this image when you want to:

• run rsyslog in a container with minimal defaults
• provide your own configuration under /etc/rsyslog.d/
• build your own downstream rsyslog-based image

⁠Default behavior

The image:

• starts rsyslogd in the foreground
• validates the configuration with rsyslogd -N1 before startup
• writes logs to standard output by default
• includes configuration snippets from /etc/rsyslog.d/*.conf

⁠Useful environment variables

• RSYSLOG_HOSTNAME: sets the hostname used inside rsyslog
• PERMIT_UNCLEAN_START: skips startup config validation when set
• RSYSLOG_ROLE: entrypoint role selector, normally left as minimal

⁠Notes

This image is the foundation for the other user-facing rsyslog container images.

Documentation: https://www.rsyslog.com/doc/containers/minimal.html⁠