Settings

Reference for every settings page. Each section links back to the feature it controls.

Workspace dialog layout

Settings open in a workspace-style dialog: a fixed sidebar on the left lists every panel, and the right side renders one panel at a time as a flat scrollable surface (no nested tabs). The activated-license footer sits in the dialog chrome so it stays visible regardless of which panel you are on. Open Settings from the gear icon, the system tray, or Spotlight (Cmd/Ctrl+; then search "Settings").

Sidebar visibility controls

Two settings let you tailor the main app sidebar and the Kubernetes sidebar to your workflow:

• Main sidebar — per-item show/hide — hide entries you never use (for example Networks if you only run host networking, or Templates if you write your own Compose files). Hidden items still show up in Spotlight.
• Kubernetes sidebar — per-group default expand state — choose which groups (Workloads, Networking, Config & Storage, RBAC, Cluster) open by default when you connect to a cluster. The setting is decoupled from runtime collapse, so flipping a section closed during a session does not overwrite your default.
• Kubernetes sidebar — per-item visibility — same hide/show control as the main sidebar, scoped to the K8s tree.

Reset to defaults at any time from the same panel.

Runtime settings

Use the runtime preference selector to choose between Auto, Docker, and Podman. Auto tries Docker first, then Podman. The detected runtime is shown below the selector after a successful connection. When connected to Podman, Compose features are automatically disabled.

Docker settings

Use Docker settings to choose the connection type, set a socket path, and inspect connection status. For SSH-backed connections, see Remote Hosts.

Daemon config panel

Use the Daemon config panel to edit daemon.json in either a form view or a raw JSON view. Registry mirrors are especially useful on Windows with the WSL2 Engine, and Windows platform shows where that file lives.

Kubernetes DNS settings

Use Kubernetes DNS settings to enable automatic DNS for port forwards. See Port Forward & DNS for the behavior it controls.

Kubernetes port forward settings

Use Kubernetes port forward settings to set the default local port range, retry behavior, and auto-reconnect.

License settings

Use License settings to activate, view, and reset your Dockerman license. See Licensing for the full flow.

Notification settings

Use Notification settings to control which events trigger a notification and whether Dockerman shows an in-app banner, a system notification, or both.

Notification channels

Manage external notification channels (Telegram, ntfy, Gotify, Discord, Webhook) from the dedicated Notifications page. Each channel uses a Shoutrrr-compatible URL, and credentials are stored in your system Keychain.

Alert rules

Configure alert rules that connect Docker events and resource metrics to your notification channels. See Alert Rules for the full setup.

Image upgrade watches

Configure background image monitoring and default notification channels from the Image Upgrade Watches page.

Privacy settings

Use Privacy settings to toggle product analytics and crash reporting. Both are opt-in by default.

Shortcut settings

Use Shortcut settings to customize or unbind anything listed in Keyboard Shortcuts.

Terminal settings

Use Terminal settings to change the font family, font size, cursor style, theme, and default shell preference for new terminals.

Tray settings

Use Tray settings to show or hide the tray icon, minimize Dockerman to the tray on close, and edit the tray menu actions.

CLI settings

Added in v5.3.0. Use the CLI panel to install, update, or uninstall the bundled dockerman CLI binary on your PATH. The same panel hosts the AI Assistant Plugins section with one-line install commands for Claude Code (/plugin marketplace add ...) and Codex (codex plugin marketplace add ...), each with a per-agent Copy button. See the CLI overview for the binary install flow and AI Assistant Plugins for what the plugin bundles.

Trivy settings

Use Trivy settings to set the Trivy binary path, the vulnerability database update interval, and the default severity filters. The panel also runs a CLI version check and offers a one-click Update button when a newer Trivy CLI release is available (added in v5.3.0). See Scan with Trivy for the scan flow.

Tasks settings

Manage the background task scheduler from this panel: enable/disable individual tasks, change their schedule, and trigger an immediate run. Built-in tasks (stats_aggregation, stats_retention_prune, image_upgrade_check) are locked from deletion but remain fully configurable.

Language and region

Dockerman ships with full localization for English, 简体中文, 日本語, and Español. Pick a language to change every UI string, including dialog copy, alerts, and the diagnostic bundle UI. Relative time formatting follows your selected locale via Intl.RelativeTimeFormat.