🐚 Bash One-Liners

For sysadmins who prefer the terminal, you can interact with TunnelSats using standard curl and jq.

Generate a 1-month invoice for a specific region directly to your console.

Replace <payment_hash> with the hash returned from the previous step.

Once paid, run this to save your WireGuard config. Note that we handle both .fullConfig and .config keys to ensure compatibility.

Query real-time subscription status using your WireGuard public key (no auth needed).

Force a real-time data sync from the VPN server. Requires an API key.

When listing all subscriptions for an authenticated account, the API returns snake_case keys (e.g., payment_hash instead of paymentHash).

Add this script to your crontab to check expiry and generate a new invoice if needed.

For the full bandwidth reset workflow including threshold validation and payment settlement, see ⚡ Bandwidth Top-Up.