Architecture
When to Use This Setup
Use Siphon when...
GPU machine uptime is uncertain; keystore isolation from workload processing is needed; multiple GPU machines should run behind one Orchestrator identity; or LPT inflation rewards are needed before GPU infrastructure is ready.
Use combined go-livepeer when...
A single machine is sufficient and reward calling alongside workloads fits the operational model. The standard Setup Guide covers this path.
Prerequisites
The secure machine needs stability, restricted access, and reliable outbound Arbitrum RPC connectivity. A small VPS (1 vCPU, 512 MB RAM) is sufficient.Part 1 - Secure Machine: Install OrchestratorSiphon
Part 2 - GPU Machine: Install go-livepeer in Transcoder Mode
Verifying the Split is Working
Once both machines are running, confirm each side is operating correctly. Secure machine (Siphon):Check Siphon reward activity
Check go-livepeer workload activity
Day-to-Day Operations
With the split setup running, ongoing workload is minimal. Secure machine - mostly automatic:- Siphon calls
reward()each round with no intervention needed - ETH fees are swept to the receiver address when the threshold is met
- Check
journalctl -u orchSiphonperiodically for errors - Keep ETH balance above
eth_warnand top up when Siphon logs balance warnings
- Monitor workload activity and metrics
- Restart cleanly after upgrades or hardware changes
- Ensure the IP or DNS entry stays valid so the service URI resolves
Adding a Second GPU Machine
To add a second GPU machine:- Install go-livepeer in transcoder mode on the new machine
- Point
-orchAddrat the same service URI, or at a load balancer serving both machines - The Orchestrator’s advertised capacity increases as Gateways observe higher throughput
Troubleshooting
Siphon failing to call rewards - gas error
Siphon failing to call rewards - gas error
The Orchestrator wallet ETH balance has dropped below the amount needed for gas. The
eth_minval is intended to prevent this, but sharp Arbitrum gas spikes or unexpectedly fast fee
accumulation still drain the wallet when the threshold is set too low.Check the balance in Siphon logs, then top up the Orchestrator address with ETH on
Arbitrum One. Siphon resumes automatically.GPU machine idle
GPU machine idle
- Verify the service URI on-chain resolves to the GPU machine’s IP or hostname
- Check port 8935 is open and reachable from the internet
- Confirm go-livepeer started successfully in transcoder mode - check for GPU detection in startup logs
- Check the Livepeer Explorer to confirm the Orchestrator is in the active set and the service URI is listed correctly
- Confirm pricing is within the range Gateways will accept - a
-pricePerUnitvalue above the market range stops work from routing regardless of uptime
Need to change the GPU machine's IP address
Need to change the GPU machine's IP address
- Update the DNS record or IP configuration first
- Trigger Siphon’s interactive mode and update the service URI to the new address
- Wait a few minutes for the on-chain update to propagate
- Verify the new URI appears on the Livepeer Explorer before testing incoming work
Siphon while the GPU machine is offline
Siphon while the GPU machine is offline
Yes. Siphon manages on-chain actions independently. The Orchestrator continues claiming
LPT inflation rewards each round regardless of whether the GPU machine is running. The
only consequence of the GPU machine being offline is that Gateways cannot route work to
it - staked LPT and reward schedule are unaffected.
Related Pages
Alternate Deployments
Overview of all three alternate deployment options and how to choose between them.
O-T Split Setup
The O-T split using go-livepeer on both machines, with keystore handling kept on the
Orchestrator host.
Earnings and Rewards
How LPT inflation rewards and transcoding fees work - the two revenue streams Siphon helps protect.
Reward Calling
Reward calling mechanics, gas cost breakdown, and what happens when a round is missed.