# Shopify/toxiproxy

:alarm_clock: :fire: A TCP proxy to simulate network and system conditions for chaos and resiliency testing

Repository: https://github.com/Shopify/toxiproxy
Canonical: https://ross.abutalabs.com/products/toxiproxy
Homepage: https://github.com/shopify/toxiproxy
Language: Go
License: MIT
License Family: permissive
Topics: resiliency, tcp-proxy, go, proxy, chaos, testing, omg, is, down
Last push: 2026-08-25T19:40:05+00:00

## Health v2 (maintenance only)
Score: 74/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 28, longevity 100
- inputs: {"age_days": 4381, "days_push": 8, "days_rel": 533, "gap_med": 80.0, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 12285, forks 508 (observed 2026-08-28T04:10:52.252991+00:00)

## What it is
Toxiproxy is a TCP proxy written in Go for simulating network and system conditions such as latency, bandwidth limits, and connection failures. It is controlled via an HTTP API and client libraries, designed for deterministic fault injection in testing, CI, and development environments.

## Use cases
- simulate network latency in tests
- test application resiliency to database outages
- inject packet loss and bandwidth limits in CI
- verify no single points of failure in distributed systems
- simulate slow or broken connections to Redis or MySQL
- chaos testing of network conditions

## When to choose
- you need deterministic, programmable network fault injection for tests or CI
- you want to test how your app handles latency, timeouts, or service outages
- you need a lightweight TCP proxy with an HTTP API and client libraries

## When to avoid
- you need HTTP-level or application-layer fault injection rather than raw TCP
- you need a production traffic proxy rather than a testing tool
- you need full-scale chaos engineering across infrastructure rather than connection-level testing

## Facets
- artifact type: service
- maturity: stable
- function: proxy, testing, http-server, cli
- domain: testing, networking, developer-tools
- platform: go, windows, cli
- tags: chaos-engineering, resiliency-testing, tcp-proxy, fault-injection, network-simulation, ci, devops, linux, macos, docker

## Member repositories
- Shopify/toxiproxy (main) score 74

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:52.252991+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:14:11.459044+00:00, confidence not recorded.
  - readme: https://github.com/Shopify/toxiproxy (fetched 2026-08-28T04:10:52.252991+00:00, sha b3ab49c907fa)
  - homepage: https://github.com/shopify/toxiproxy (fetched 2026-08-29T08:11:27.536546+00:00, sha 8e854d02ae87)
- Data as of 2026-08-30T08:39:29.467469+00:00.