This is a docker container based on Alpine Linux with logrotate
.
Simply mount a directory with your logs into the container at /logs
and optionally
configure some logrotation features with the following environment variables:
LOGROTATE_FILE_PATH
(defaultvar/log
): File path to observeLOGROTATE_FILE_PATTERN
(default:*.log
): File pattern within the/var/log
directory for logs to be rotated bylogrotate
LOGROTATE_TRUNCATE
(default:copytruncate
): Truncation behaviour of logrotate, use eithercopytruncate
ornocopytruncate
LOGROTATE_COMPRESS
(default:nocompress
): Compression behaviour for rotated files, use eithernocompress
orcompress
LOGROTATE_ROTATE
(default:5
): Therotate
option of logrotateLOGROTATE_SIZE
(default50M
): thesize
option of logrotateLOGROTATE_POSTROTATE
(default:echo 'test'
): run script after rotation
If you want to use a different logrotate configuration, mount a logrotate.conf
at /etc/logrotate.conf
into the container. The environment variables mentioned above have no effect if you supply your own
logrotate configuration file.
By default, logrotate
is run periodically every 15 minutes. You can override the cron schedule with
the environment variable LOGROTATE_CRON
. Use one of Alpine Linux' predefined periods
(15min
, hourly
, daily
, weekly
or monthly
) or specify a cron schedule expression like
5 4 * * *
(at 04:05 every day). If you are unsure about the cron schedule expression syntax,
consult a tool like crontab guru.
docker run \
-v /path/to/my/logs:/logs \
-e LOGROTATE_FILE_PATTERN="*.log" \
# don't rotate at all but truncate logs when they exceed the configured rotation size
-e LOGROTATE_ROTATE="0" \
# run logrotate every 5 minutes
-e LOGROTATE_CRON="*/5 0 0 0 0" \
linkyard:logrotate
This image is somewhat similar to the no longer maintained blacklabelops/logrotate but a lot simpler to use and maintain.
Forked from linkyard/docker-logrotate