# TunnelSats - Bitcoin Lightning Hybrid VPN Documentation

> TunnelSats provides privacy-preserving WireGuard VPN tunnels with static IPv4 endpoints and dedicated port forwarding (port 9735) purpose-built for Bitcoin Lightning Network nodes (LND, Core Lightning, Eclair) running in Hybrid Mode (Tor + Clearnet over VPN). Subscriptions are anonymous (no KYC, no email required) and payable via Bitcoin Lightning or automated via Nostr Wallet Connect (NWC).

## Core Documentation (Markdown & Plain Text)

- [Setup & Platform Installation Guide](https://tunnelsats.com/guide): Step-by-step installation and hybrid configuration for Umbrel App (umbrelOS 1.0+), StartOS 0.4 Native Package, RaspiBlitz, RaspiBolt, myNode, and Bare Metal Linux (`tunnelsats.sh`).
  - Raw Markdown: https://tunnelsats.com/guide.md
  - Plain Text: https://tunnelsats.com/guide.txt
- [Frequently Asked Questions (FAQ)](https://tunnelsats.com/faq): Detailed Q&A covering Hybrid Mode architecture, privacy and zero-log RAM-only peer state, pricing & discounts, 100GB monthly bandwidth & $1 resets, NWC auto-renewal, server consolidation (de1/de3 to de2, us1 to us3), Mullvad/Tailscale coexistence, Tor tuning, and referral bonuses.
  - Raw Markdown: https://tunnelsats.com/faq.md
  - Plain Text: https://tunnelsats.com/faq.txt
- [Community, Nostr (Armada) & Troubleshooting Support](https://tunnelsats.com/support): Official support channels (Armada Nostr Community, Telegram, GitHub Issues, Amboss Community), how to join Armada on Nostr and interact with the TunnelSats Bot (`npub1n9z4y3xjramqes8fp9rl96x5e4nl0hff57ynw7vqnjpq370tq78sljsp8y`), diagnostic troubleshooting checklist, and anti-scam security rules.
  - Raw Markdown: https://tunnelsats.com/support.md
  - Plain Text: https://tunnelsats.com/support.txt

## Developer & Programmatic Public API

- [Public API Reference](https://api.tunnelsats.com): Full interactive OpenAPI documentation for programmatic server discovery, Lightning invoice creation, WireGuard config claiming, renewals, and bandwidth resets.
- [OpenAPI 3.0.3 & MPP Specification](https://tunnelsats.com/openapi.json): Machine-readable OpenAPI 3.0.3 specification with Machine Payment Protocol (`x-payment-info` and `x-service-info`) Bitcoin Lightning metadata.
- [Public API LLM Index](https://api.tunnelsats.com/llms.txt): Structured API endpoint index and OpenAPI 3.0 specifications for AI agents.
- [HTTP 402 Agent Gateway (L402 & x402)](https://tunnelsats.com/api/v1): Unified HTTP `402 Payment Required` endpoint supporting Lightning Labs L402 (`WWW-Authenticate: L402` + preimage verification) and `x402` (`PAYMENT-REQUIRED`) envelopes.
- [Agent Authentication & Provisioning Discovery (auth.md)](https://tunnelsats.com/auth.md): Self-contained specification for anonymous Lightning/WireGuard provisioning, L402/x402 HTTP 402 payments, stateless Nostr NIP-98 authentication, and Bearer API keys.
- [RFC 9727 API Catalog](https://tunnelsats.com/.well-known/api-catalog): Machine-readable `application/linkset+json` catalog of TunnelSats API endpoints, specifications, and health checks.

## Live Service & Transparency Pages

- [System Status & Regional Latency](https://tunnelsats.com/status): Real-time WireGuard gateway health, capacity, and Globalping latency telemetry across North America, Europe, Asia, and Latin America.
- [Transparency & Warrant Canary](https://tunnelsats.com/transparency): Cryptographically verifiable warrant canary and privacy commitments.

## Community & Support Quick Links

- Armada Nostr Community (NIP-17 / Concord V2 Encrypted): https://tunnelsats.com/join-armada
- Official TunnelSats Nostr Bot: nostr:npub1n9z4y3xjramqes8fp9rl96x5e4nl0hff57ynw7vqnjpq370tq78sljsp8y
- Telegram Community: https://tunnelsats.com/join-telegram
- Amboss Routing Community: https://amboss.space/community/29db5f25-24bb-407e-b752-be69f9431071
- GitHub Issue Tracker: https://github.com/tunnelsats/tunnelsats/issues