Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.
Go aialertsdashboarddockerdocker-monitoringgohomelabinfrastructure-monitoringkubernetesmonitoringmspproxmoxproxmox-backup-serverproxmox-mail-gatewayproxmox-veself-hostedtruenastypescriptvspherewebhooks
Explain HTTPS-only image checks before registry login
pulse-triage[bot]c8a26ae57164
diff --git a/docs/DOCKER.md b/docs/DOCKER.mdindex 61435e27fd..978af84011 100644--- a/docs/DOCKER.md+++ b/docs/DOCKER.md@@ -473,6 +473,19 @@ not on the Pulse server. It uses the login visible to that agent process;a successful pull in another user's shell does not prove the agent canauthenticate. Detection does not require enabling command execution.+**HTTPS is required for registry checks.** The agent contacts the registry+directly over HTTPS; Docker's `insecure-registries` setting does not apply, and+Pulse has no plain-HTTP registry option. A successful Docker pull from an+HTTP-only registry does not establish support for Pulse's update check.++If the existing error says `http: server gave HTTP response to HTTPS client`,+the selected endpoint is serving HTTP where the checker expects TLS. This is+not evidence of a missing login; changing registry credentials or adding them+to the Pulse server will not repair that protocol mismatch. The supported+route is an HTTPS registry endpoint, directly or through a TLS reverse proxy,+with a certificate trusted by the agent. Do not disable TLS verification or+send registry passwords over HTTP to test this.+**Native agent:** use its actual service account, home and service environment.Root and least-privilege installations can use different accounts. Log ininteractively in the intended account and environment:diff --git a/frontend-modern/public/docs/DOCKER.md b/frontend-modern/public/docs/DOCKER.mdindex 61435e27fd..978af84011 100644--- a/frontend-modern/public/docs/DOCKER.md+++ b/frontend-modern/public/docs/DOCKER.md@@ -473,6 +473,19 @@ not on the Pulse server. It uses the login visible to that agent process;a successful pull in another user's shell does not prove the agent canauthenticate. Detection does not require enabling command execution.+**HTTPS is required for registry checks.** The agent contacts the registry+directly over HTTPS; Docker's `insecure-registries` setting does not apply, and+Pulse has no plain-HTTP registry option. A successful Docker pull from an+HTTP-only registry does not establish support for Pulse's update check.++If the existing error says `http: server gave HTTP response to HTTPS client`,+the selected endpoint is serving HTTP where the checker expects TLS. This is+not evidence of a missing login; changing registry credentials or adding them+to the Pulse server will not repair that protocol mismatch. The supported+route is an HTTPS registry endpoint, directly or through a TLS reverse proxy,+with a certificate trusted by the agent. Do not disable TLS verification or+send registry passwords over HTTP to test this.+**Native agent:** use its actual service account, home and service environment.Root and least-privilege installations can use different accounts. Log ininteractively in the intended account and environment:diff --git a/scripts/tests/test_docker_registry_docs.py b/scripts/tests/test_docker_registry_docs.pyindex d731907b12..2ff9bdc82b 100644--- a/scripts/tests/test_docker_registry_docs.py+++ b/scripts/tests/test_docker_registry_docs.py@@ -36,6 +36,24 @@ class DockerRegistryDocsTest(unittest.TestCase):self.assertNotIn("the installer's systemd service runs the agent as root", text)self.assertIn("only for an agent that actually runs as root", text)+ def test_http_only_registry_is_not_a_credential_setup_problem(self):+ text = prose()+ for fact in ("HTTPS is required for registry checks",+ "Docker's `insecure-registries` setting does not apply",+ "no plain-HTTP registry option",+ "http: server gave HTTP response to HTTPS client",+ "not evidence of a missing login",+ "will not repair that protocol mismatch",+ "TLS reverse proxy", "certificate trusted by the agent",+ "send registry passwords over HTTP to test this"):+ self.assertIn(fact, text)+ # Explain transport before asking operators to log in. This is a+ # source-bound documentation assertion, not installed-registry proof.+ self.assertLess(text.index("HTTPS is required"), text.index("**Native agent:**"))+ source = (ROOT / "internal/dockeragent/registry.go").read_text()+ self.assertIn('fmt.Sprintf("https://%s/v2/%s/manifests/%s"', source)+ self.assertIn("MinVersion: tls.VersionTLS12", source)+def test_paths_and_cache_match_the_existing_producer(self):text = section()source = (ROOT / "internal/dockeragent/registry_credentials.go").read_text()