From ae05011062fea40a02dac7474f0c033c54b3e79b Mon Sep 17 00:00:00 2001 From: Michael Wieland Date: Mon, 29 Jan 2024 20:07:40 +0100 Subject: [PATCH] Documentation: Add docs about missing timezones in MySQL/MariaDB (#5583) --------- Co-authored-by: shamoon <4887959+shamoon@users.noreply.github.com> --- docs/advanced_usage.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/advanced_usage.md b/docs/advanced_usage.md index 1d76b10d6..04626fe41 100644 --- a/docs/advanced_usage.md +++ b/docs/advanced_usage.md @@ -517,6 +517,18 @@ existing tables) with: an older system may fix issues that can arise while setting up Paperless-ngx but `utf8mb3` can cause issues with consumption (where `utf8mb4` does not). +### Missing timezones + +MySQL as well as MariaDB do not have any timezone information by default (though some +docker images such as the official MariaDB image take care of this for you) which will +cause unexpected behavior with date-based queries. + +To fix this, execute one of the following commands: + +MySQL: `mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root mysql -p` + +MariaDB: `mariadb-tzinfo-to-sql /usr/share/zoneinfo | mariadb -u root mysql -p` + ## Barcodes {#barcodes} Paperless is able to utilize barcodes for automatically performing some tasks.