# Proxy Hopper

## Docs

- [GraphQL API](https://proxy-hopper.io/admin/admin-server/graphql.md): Query and mutate targets, IP pools, and providers at runtime via the GraphQL management API.
- [Admin Server](https://proxy-hopper.io/admin/admin-server/overview.md): The Proxy Hopper admin server provides a REST health endpoint, a login endpoint, and the GraphQL management API — all on a separate port from the proxy.
- [API Key Authentication](https://proxy-hopper.io/admin/authentication/api-keys.md): Configure API keys for service-to-service access to Proxy Hopper.
- [Authentication Overview](https://proxy-hopper.io/admin/authentication/overview.md): Proxy Hopper's authentication system — when to enable it, what token types are supported, and how access control works.
- [SSO Authentication](https://proxy-hopper.io/admin/authentication/sso.md): Configure OpenID Connect (OIDC) for single sign-on with your identity provider.
- [Authentik](https://proxy-hopper.io/admin/authentication/sso-guides/authentik.md): Configure Authentik as an OIDC identity provider for Proxy Hopper.
- [Azure Active Directory](https://proxy-hopper.io/admin/authentication/sso-guides/azure.md): Configure Azure AD (Entra ID) as an OIDC identity provider for Proxy Hopper.
- [User-Based Authentication](https://proxy-hopper.io/admin/authentication/user-based.md): Configure local user accounts with username and password for JWT-based access.
- [Environment Variables](https://proxy-hopper.io/admin/configuration/environment-variables.md): All PROXY_HOPPER_* environment variables and what they do.
- [Config Reference](https://proxy-hopper.io/admin/configuration/reference.md): Complete reference for all Proxy Hopper configuration fields.
- [Advanced Docker Deployment](https://proxy-hopper.io/admin/deployment/docker/advanced.md): Docker Compose with Redis backend, multiple replicas, load balancing, and Prometheus metrics.
- [Simple Docker Deployment](https://proxy-hopper.io/admin/deployment/docker/simple.md): Run Proxy Hopper as a single container with the in-memory backend.
- [Deploying with Helm](https://proxy-hopper.io/admin/deployment/kubernetes/helm.md): Install Proxy Hopper on Kubernetes using the official Helm chart.
- [High Availability](https://proxy-hopper.io/admin/deployment/kubernetes/high-availability.md): Run Proxy Hopper at scale with HPA, Redis, and production hardening.
- [Monitoring](https://proxy-hopper.io/admin/deployment/kubernetes/monitoring.md): Prometheus metrics and Grafana dashboards for Proxy Hopper on Kubernetes.
- [Logging](https://proxy-hopper.io/admin/observability/logging.md): Log levels, formats, and what each level tells you.
- [Prometheus Metrics](https://proxy-hopper.io/admin/observability/metrics.md): Full reference for all Proxy Hopper Prometheus metrics.
- [Client Identities](https://proxy-hopper.io/concepts/identities.md): How Proxy Hopper attaches a persistent browser persona to each (IP, target) pair to reduce bot detection and session-level rate limiting.
- [IP Pools](https://proxy-hopper.io/concepts/ip-pools.md): IP pools are named collections of proxy IPs that targets use for rotation. They draw IPs from providers and serve as the link between your provider subscriptions and your routing rules.
- [Proxy Providers](https://proxy-hopper.io/concepts/proxy-providers.md): Proxy providers are the external services that supply the IP addresses Proxy Hopper rotates through. This page explains what to look for in a provider and how to configure one.
- [Sending Requests](https://proxy-hopper.io/concepts/sending-requests.md): How to send requests through Proxy Hopper using the X-Proxy-Hopper-Target header.
- [Targets](https://proxy-hopper.io/concepts/targets.md): Targets represent the third-party APIs you want to route requests through Proxy Hopper. Each target has its own IP pool, rate limit policy, and retry behaviour.
- [Architecture](https://proxy-hopper.io/contributors/architecture.md): How Proxy Hopper is structured internally — components, data flow, and design principles.
- [Contributing](https://proxy-hopper.io/contributors/contributing.md): How to contribute to Proxy Hopper — setting up the dev environment, writing tests, and submitting pull requests.
- [Running Tests](https://proxy-hopper.io/contributors/testing.md): How to run the proxy-hopper test suites locally.
- [Authenticating](https://proxy-hopper.io/developers/authenticating.md): How to authenticate your application's requests to Proxy Hopper.
- [Getting Started as a Developer](https://proxy-hopper.io/developers/getting-started.md): Everything a developer needs to start sending requests through Proxy Hopper from their application.
- [Migrating to Proxy Hopper](https://proxy-hopper.io/developers/migrating.md): How to migrate an existing application to send requests through Proxy Hopper.
- [Proxy Hopper](https://proxy-hopper.io/index.md): A rotating HTTP/HTTPS proxy server that routes outbound requests through a pool of external proxy IP addresses.
- [Introduction](https://proxy-hopper.io/introduction.md): What Proxy Hopper is, how it works, and when to use it.
- [Quick Start](https://proxy-hopper.io/quickstart.md): Install Proxy Hopper, write a config file, and send your first proxied request.

## OpenAPI Specs

- [openapi](https://proxy-hopper.io/api-reference/openapi.json)

## Optional

- [GitHub](https://github.com/cams-data/proxy-hopper-v2)
- [Releases](https://github.com/cams-data/proxy-hopper-v2/releases)