Tutorials
Run a Rotation Runtime
Start a local HTTP/CONNECT endpoint that rotates traffic across saved proxy sources.
The Rotation Engine exposes a local proxy endpoint that selects proxies from pool-backed or inline sources.
1. Prepare a Source Pool
Use a pool that has already passed checking, benchmarking, and leak testing when possible.
Good pool tags:
checkedbenchmarkedleak-cleanhttps
2. Create a Rotator
- Open Rotation Engine -> Rotators.
- Create a rotator named
Docs rotation demo. - Add a saved pool source.
- Add inline proxies only if they are temporary or not yet pool-worthy.
- Choose a selection strategy.
- Attach the Balanced Rotation policy.
- Save.
3. Choose Strategy
| Strategy | Use when |
|---|---|
| Round robin | You want predictable rotation across available proxies. |
| Random | You want less predictable selection. |
| Least recently used | You want to spread usage across proxies that have waited longest. |
4. Start Runtime
- Choose a requested local port.
- Enable auto-start if needed.
- Start runtime.
- Copy the bound endpoint URL.
Use the endpoint as an HTTP proxy:
http://127.0.0.1:<bound-port>5. Monitor Runtime
Open Rotation Engine -> Traffic and watch:
- active source
- active proxy
- decision and reason
- session key
- status code
- request and response bytes
- cooling and quarantined counts
- switch count
Rotation policy controls when a proxy is reused, rotated, cooled down, quarantined, or skipped due to concurrency.