SAVE IMAGE connection refused

TL;DR

A user reported the following error when he attempted to run a build with a SAVE IMAGE on Jenkins CI with Linux. ``` [2024-01-22T23:20:34.964Z] output | --> exporting outputs [2024-01-22T23:20:47.159Z] output | [----------] 100% exporting outputs[K [2024-01-22T23:20:55.244Z] Error: pull ping error: pull ping response: rpc error: code = Unknown desc = image pull: 1 error occurred: [2024-01-22T23:20:55.244Z] * command failed: docker pull the loopback address:35137/sess-jwd728vcbn4ni32eu360wnxmi/pullping:img-0: exit status 1: Error response from...

Steps

1. Issue earthly/earthly#3736 (closed, 6 comments): What went wrong?
2. A user reported the following error when he attempted to run a build with a SAVE IMAGE on Jenkins CI with Linux.
3. `

[2024-01-22T23:20:34.964Z] output | --> exporting outputs [2024-01-22T23:20:47.159Z] output | [----------] 100% exporting outputs[K [2024-01-22T23:20:55.244Z] Error: pull ping error: pull ping response: rpc error: code = Unknown desc = image pull: 1 error occurred: [2024-01-22T23:20:55.244Z] * command failed: docker pull the loopback address:35137/sess-jwd728vcbn4ni32eu360wnxmi/pullping:img-0: exit status 1: Error response from...

4. When Earthly runs inside Docker it cannot reach its registry proxy on the host loopback, which causes the connection-refused on save. Either pass --disable-remote-registry-proxy or run the container with host networking.

When to use

You are seeing this: Issue earthly/earthly#3736 (closed, 6 comments): What went wrong? Use this skill when you run into "SAVE IMAGE connection refused".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

In the GitHub issue gh:earthly/earthly#3736 (https://github.com/earthly/earthly/issues/3736), the problem reported was: Issue earthly/earthly#3736 (closed, 6 comments): What went wrong?

A user reported the following error when he attempted to run a build with a SAVE IMAGE on Jenkins CI with Linux.

[2024-01-22T23:20:34.964Z]               output | --> exporting outputs
[2024-01-22T23:20:47.159Z]               output | [----------] 100% exporting outputs[K
[2024-01-22T23:20:55.244Z] Error: pull ping error: pull ping response: rpc error: code = Unknown desc = image pull: 1 error occurred:
[2024-01-22T23:20:55.244Z] 	* command failed: docker pull the loopback address:35137/sess-jwd728vcbn4ni32eu360wnxmi/pullping:img-0: exit status 1: Error response from... The verified resolution was: When Earthly runs inside Docker it cannot reach its registry proxy on the host loopback, which causes the connection-refused on save. Either pass --disable-remote-registry-proxy or run the container with host networking.