Skip to content

armgit / Pulse

Public Imported from GitHub
0

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.

Explain HTTPS-only image checks before registry login

pulse-triage[bot]c8a26ae57164
diff --git a/docs/DOCKER.md b/docs/DOCKER.md
index 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 can
authenticate. 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 in
interactively in the intended account and environment:
diff --git a/frontend-modern/public/docs/DOCKER.md b/frontend-modern/public/docs/DOCKER.md
index 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 can
authenticate. 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 in
interactively in the intended account and environment:
diff --git a/scripts/tests/test_docker_registry_docs.py b/scripts/tests/test_docker_registry_docs.py
index 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()