Skip to content

chore(reach): bake net + debug tools into the sandbox image#7

Merged
todie merged 1 commit into
mainfrom
chore/dockerfile-net-tools
Apr 7, 2026
Merged

chore(reach): bake net + debug tools into the sandbox image#7
todie merged 1 commit into
mainfrom
chore/dockerfile-net-tools

Conversation

@todie

@todie todie commented Apr 7, 2026

Copy link
Copy Markdown
Member

Summary

Add `iproute2`, `net-tools`, `dnsutils`, `iputils-ping`, `jq`, `procps`, `less`, and `wget` to the runtime layer of the reach Docker image.

Why

Original layer 1 only had `curl`. Debugging "is service X actually listening?" inside the sandbox required `apt-get install` at exec time — slow, ugly, and impossible when the container is offline.

These are baseline Linux troubleshooting tools (`ss`, `dig`, `ping`, `netstat`, `jq`, `ps`). Image size delta is ~12 MB compressed; the convenience cost of NOT having them at the ready is much higher than that.

Discovered while

Wiring Chrome's remote debugging port through reach to a host process — had to apt-install iproute2 + net-tools inside the running sandbox just to verify the port was bound on `0.0.0.0:9222`.

Test plan

  • Dockerfile syntax checked locally (`docker build` not run in PR — CI will exercise it)
  • CI Docker Build job picks up the new layer
  • Smoke test: `docker run --rm reach:latest ss --version` returns version

🤖 Generated with Claude Code

Add iproute2, net-tools, dnsutils, iputils-ping, jq, procps, less, and
wget to the runtime image. The original layer 1 only had curl, which
made debugging "is service X actually listening?" inside the sandbox
require an apt-get install at exec time — slow, ugly, and impossible
when the container is offline.

These are baseline troubleshooting tools every Linux box has. Total
image size delta is ~12 MB compressed; the convenience cost of NOT
having ss/dig/ping at the ready is much higher than that.

Driven by a session where I had to apt-install iproute2 + net-tools
inside a running sandbox just to verify Chrome's remote debugging port
was bound on 0.0.0.0:9222.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@todie todie merged commit e09ec97 into main Apr 7, 2026
9 of 11 checks passed
@todie todie deleted the chore/dockerfile-net-tools branch April 7, 2026 11:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant