Persistence

The Persistence package enables modification of core system files in /etc that are otherwise reset on reboot. All configuration is done through the package’s built-in user interface.

Note

Installing this package is optional, but recommended. It is particularly useful for managing Docker log rotation and custom /etc/hosts entries.

Installation

Tabs

The user interface is divided into three tabs.

Hosts

Appends custom entries to /etc/hosts on startup. Place host files at /share/Configuration/*/deps.d/persistence/hosts. Useful for resolving internal hostnames without a DNS server. Apply button saves and activates the configuration immediately.

DNS

Optionally replaces /etc/resolv.conf on startup. Useful for adding custom search directives. Apply button saves and activates the configuration immediately.

Docker

Configures /etc/docker/daemon.json on startup. Available settings include:

  • log-driver: Set to local to enable log rotation. Defaults to the Docker default.

  • log-opts.max-size: Maximum size of a single log file (e.g. 256m, 1g). Only visible when log-driver uses this setting.

  • log-opts.max-file: Maximum number of log files to retain per container. Only visible when log-driver uses this setting.

  • live-restore: The live restore option helps reduce container downtime due to daemon restarts.

  • metrics-addr: Turn on the internal Prometheus exporter for collecting stats on the Docker daemon.

Note

Saving the Docker configuration does not automatically restart Docker.