From 70037f0e3a032510b5e02e993752404247eac14b Mon Sep 17 00:00:00 2001 From: John Gatward Date: Tue, 20 Oct 2026 10:01:52 +0100 Subject: [PATCH] [main]: Add logging rotation --- docs/home-server/host.md | 37 +++++++++++++++++++++++++++++++++++-- 1 file changed, 35 insertions(+), 2 deletions(-) diff --git a/docs/home-server/host.md b/docs/home-server/host.md index 26a0641..ac87c96 100644 --- a/docs/home-server/host.md +++ b/docs/home-server/host.md @@ -4,7 +4,7 @@ id: home-server.host type: reference scope: [jupiter, hardware, operating-system, docker] sensitivity: private-infrastructure -last_reviewed: "2026-10-06" +last_reviewed: "2026-10-20" sources: - kind: owner-report reference: "Hardware, OS, bare-metal Docker and data-root confirmation, 2026-10-06" @@ -12,6 +12,8 @@ sources: reference: "hostnamectl, timedatectl, user/group records, Docker info/version and systemd units, 2026-10-06" - kind: owner-report reference: "Owner does not recognize backup-puller account; no independent host-config archive, 2026-10-06" + - kind: owner-report + reference: "Added local logging driver with max-size 10m and max-file 3 to /etc/docker/daemon.json, 2026-10-20" related: [home-server.reference, home-server.storage, home-server.networking, home-server.deployment, home-server.operations] update_triggers: [hardware-change, os-upgrade, kernel-upgrade, docker-reconfiguration, account-change, unit-change] unknowns: @@ -19,6 +21,7 @@ unknowns: - jupiter-firewall-policy - docker-package-installation-source - backup-puller-account-purpose + - docker-logging-restart-and-container-recreation --- # Host @@ -50,7 +53,7 @@ unknowns: | containerd / runc | `v2.3.6` / `1.5.1` | | Storage | `overlayfs`; containerd snapshotter | | Cgroups | `systemd`; v2 | -| Logging | `json-file`; default | +| Logging | `local` configured in `/etc/docker/daemon.json`; `max-size: 10m`, `max-file: 3`; activation not confirmed (previously observed default: `json-file`) | | Firewall backend | `iptables` | | Runtime security | AppArmor, seccomp, cgroup namespaces | | Swarm / live restore | Inactive / disabled | @@ -60,6 +63,36 @@ Docker starts `/usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd Supplied Docker unit has no explicit `/data` mount dependency or ordering against `rclone-seedbox.service`. +### Docker log rotation + +On 2026-10-20, the owner reported adding the following logging settings to +`/etc/docker/daemon.json`: + +```json +{ + "log-driver": "local", + "log-opts": { + "max-size": "10m", + "max-file": "3" + } +} +``` + +This configures automatic rotation with roughly 30 MB of uncompressed log +retention per container; the `local` driver also compresses rotated logs. +It covers container stdout/stderr, not application log files written inside +containers or mounted volumes. + +A Docker daemon restart and recreation of existing containers are required to +apply this default to them; neither is confirmed by the owner report. Restarting +Docker can interrupt workloads because live restore was disabled in the supplied +snapshot. Explicit Compose/container logging settings override the daemon default. +Inspect a container's effective configuration with: + +```sh +docker inspect --format '{{json .HostConfig.LogConfig}}' CONTAINER +``` + ## Host administration | Account / group | Identity |