Logging
Planka supports exposing its internal log directory to the host machine via a shared Docker volume.
This feature is disabled by default.
Enable Host Log Access
To enable logging to the host, add the following volume entry under services.planka.volumes
in your docker-compose.yml
:
volumes:
- ./logs/:/app/logs/
./logs/
refers to the host machine./app/logs/
refers to the container.
This will create a logs
directory next to your docker-compose.yml
and map it to Planka's internal logging folder.
Tip: If logs aren't appearing, check file and folder permissions. You may need to
chown
orchmod
the host directory appropriately.
Log Rotation
Over time, logs can consume disk space. Use logrotate to automatically manage log size and retention.
Configure logrotate for Planka
Create a file at /etc/logrotate.d/planka
with the following content:
/path/to/planka/logs/planka.log {
daily
missingok
rotate 14
compress
delaycompress
notifempty
create 640 root adm
sharedscripts
}
Be sure to replace /path/to/planka/logs/planka.log
with your actual log file path on the host system.
To apply changes:
sudo systemctl restart logrotate
This setup will:
- Rotate logs daily
- Keep the last 14 logs
- Compress old logs to save space
- Only rotate if the log is not empty
Now your logs will be persisted on the host and managed efficiently.