From 7534d7c30a9570da6dd683ef193f7cc65f7de642 Mon Sep 17 00:00:00 2001
From: John O'Keefe <jrokeefe@protonmail.com>
Date: Wed, 29 Apr 2026 20:33:13 -0400
Subject: [PATCH] feat(config): add TZ environment variable for container
 timezone

Adds TZ env var to docker-compose.yml app service (defaults to UTC)
and documents it in .env.example. This ensures the Go runtime's
time.Local is set correctly inside the container for any server-side
time operations that don't use an explicit timezone.
---
 .env.example       | 4 +++-
 docker-compose.yml | 3 +++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/.env.example b/.env.example
index cfa212d..cdb581b 100644
--- a/.env.example
+++ b/.env.example
@@ -19,4 +19,6 @@ DBPASS=your-secure-database-password-here
 # Conversion Tool: Switch from kepubify to ebook-convert
 # BOOKHOARD_CONVERSION_TOOL=/usr/bin/ebook-convert
 # Conversion Cache TTL: Override default 24h
-# BOOKHOARD_CONVERSION_CACHE_TTL=48h
\ No newline at end of file
+# BOOKHOARD_CONVERSION_CACHE_TTL=48h
+# System timezone (fallback for server-side time operations, defaults to UTC)
+# TZ=America/New_York
\ No newline at end of file
diff --git a/docker-compose.yml b/docker-compose.yml
index 8608f7f..f140295 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -57,6 +57,9 @@ services:
       BOOKHOARD_CONVERSION_CACHE_DIR: ${BOOKHOARD_CONVERSION_CACHE_DIR:-/app/cache/kepub}
       BOOKHOARD_CONVERSION_TOOL: ${BOOKHOARD_CONVERSION_TOOL:-/usr/bin/kepubify}
       BOOKHOARD_CONVERSION_CACHE_TTL: ${BOOKHOARD_CONVERSION_CACHE_TTL:-24h}
+
+      # System timezone (fallback for server-side time operations)
+      TZ: ${TZ:-UTC}
     ports:
       - "8765:8765"
     depends_on: