[main]: Add logging rotation
This commit is contained in:
1 file changed
+35
-2
@@ -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 |
|
||||||
|
|||||||
Reference in new issue
Block a user