stacklok / stacklok/toolhive

Envoy Proxy: Make Envoy the default network proxy backend

Open
#5,946 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

p2
Dominant language
Go
Stars
2.2k
Forks
300
Avg merge
1d 15h
Merged PRs (30d)
184

Description

Goal

Flip TOOLHIVE_NETWORK_PROXY default from squid to envoy, retiring the Squid backend as the primary path for network-isolated workloads.

Prerequisites

  • #5902 (Envoy backend) — merged ✅
  • #5903 (hardening: digest pin, admin lockdown) — pending
  • #5904 (graduate toggle to RunConfig/CLI) — pending
  • Envoy e2e behavioral matrix green on Linux Docker Engine (#5917/#5922)

Tasks

  • Validate Envoy on all target platforms: Linux Docker Engine, Docker Desktop (macOS), Colima, Rancher Desktop.
  • Flip the default in newNetworkProxy from "squid" to "envoy" (one-line change).
  • Update docs to describe Envoy as the default; document Squid as the legacy fallback via TOOLHIVE_NETWORK_PROXY=squid.
  • Confirm all existing network-isolation e2e tests pass with Envoy as the default (the parametrised suite from #5917 covers this directly).
  • Release note calling out the change.

Rollback

TOOLHIVE_NETWORK_PROXY=squid restores the prior behaviour without a code change.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start at newNetworkProxy and the parametrised network-isolation e2e suite referenced in #5917/#5922. First confirm the pending Envoy hardening and RunConfig/CLI work are complete, then validate the listed platforms and update the relevant documentation and release note. Done means Envoy is the default, Squid remains available through TOOLHIVE_NETWORK_PROXY=squid, and the existing e2e tests pass.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, go
Domain
devops, networking
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.