[main]: Add logging rotation

This commit is contained in:
John Gatward committed 2026-10-20 10:01:52 +01:00
1 parent 315730c422
commit 70037f0e3a
1 file changed
+35 -2
+35 -2
View File
@@ -4,7 +4,7 @@ id: home-server.host
type: reference type: reference
scope: [jupiter, hardware, operating-system, docker] scope: [jupiter, hardware, operating-system, docker]
sensitivity: private-infrastructure sensitivity: private-infrastructure
last_reviewed: "2026-10-06" last_reviewed: "2026-10-20"
sources: sources:
- kind: owner-report - kind: owner-report
reference: "Hardware, OS, bare-metal Docker and data-root confirmation, 2026-10-06" 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" reference: "hostnamectl, timedatectl, user/group records, Docker info/version and systemd units, 2026-10-06"
- kind: owner-report - kind: owner-report
reference: "Owner does not recognize backup-puller account; no independent host-config archive, 2026-10-06" 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] 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] update_triggers: [hardware-change, os-upgrade, kernel-upgrade, docker-reconfiguration, account-change, unit-change]
unknowns: unknowns:
@@ -19,6 +21,7 @@ unknowns:
- jupiter-firewall-policy - jupiter-firewall-policy
- docker-package-installation-source - docker-package-installation-source
- backup-puller-account-purpose - backup-puller-account-purpose
- docker-logging-restart-and-container-recreation
--- ---
# Host # Host
@@ -50,7 +53,7 @@ unknowns:
| containerd / runc | `v2.3.6` / `1.5.1` | | containerd / runc | `v2.3.6` / `1.5.1` |
| Storage | `overlayfs`; containerd snapshotter | | Storage | `overlayfs`; containerd snapshotter |
| Cgroups | `systemd`; v2 | | 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` | | Firewall backend | `iptables` |
| Runtime security | AppArmor, seccomp, cgroup namespaces | | Runtime security | AppArmor, seccomp, cgroup namespaces |
| Swarm / live restore | Inactive / disabled | | 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 Supplied Docker unit has no explicit `/data` mount dependency or ordering against
`rclone-seedbox.service`. `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 ## Host administration
| Account / group | Identity | | Account / group | Identity |