Skip to main content

Overview

The in-memory backend stores all IP pool state in asyncio queues and Python dicts within the Proxy Hopper process. It requires no external dependencies and is the default.
proxy-hopper run --config config.yaml
# or explicitly:
proxy-hopper run --config config.yaml --backend memory

Characteristics

PropertyDetail
DependenciesNone
State persistenceLost on restart
Multi-instanceNot supported — each instance has its own pool
PerformanceFastest — no network round trips for pool operations

When to use it

  • Development and testing
  • Single-host deployments where pool state loss on restart is acceptable
  • High-throughput single-instance deployments where Redis latency matters

When not to use it

  • Multiple replicas behind a load balancer — each replica would have independent pool state, leading to duplicate IP usage and inconsistent quarantine
  • Deployments where IP pool state must survive restarts