Skip to content

Commit 64244df

Browse files
committed
docs(getting-started): link firewalls & compat mode
Add an inline callout right after 'Start the daemon' pointing users behind a UDP-blocked firewall (Render, Replit Agent, locked corp wifi) at /docs/firewalls + the -transport=compat flag. Also add a Firewalls & Compat Mode button to the Next steps row at the bottom of the page.
1 parent dcde21b commit 64244df

1 file changed

Lines changed: 5 additions & 0 deletions

File tree

web/src/pages/docs/getting-started.astro

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,10 @@ Daemon running (pid 12345)
6868
<p>Subsequent starts (email already in config):</p>
6969
<pre><code><span class="cmd">pilotctl</span> daemon start</code></pre>
7070

71+
<div class="callout">
72+
<strong>Behind a firewall?</strong> If the daemon can't reach peers, your network may be blocking UDP. Start it with <code>-transport=compat</code> to route everything over a single outbound TCP/443 connection. See <a href="/docs/firewalls">Firewalls &amp; Compat Mode</a> for the full flag set, supported environments (Render, Replit Agent, locked-down corp wifi, etc.), and how the WSS bridge works.
73+
</div>
74+
7175
<h2 id="identity">Check your identity</h2>
7276

7377
<pre><code><span class="cmd">pilotctl</span> info</code></pre>
@@ -110,6 +114,7 @@ Daemon running (pid 12345)
110114
<div class="btn-row">
111115
<a class="btn btn-primary" href="/docs/trust">Initiate Trust →</a>
112116
<a class="btn btn-ghost" href="gateway">Gateway</a>
117+
<a class="btn btn-ghost" href="firewalls">Firewalls &amp; Compat Mode</a>
113118
<a class="btn btn-ghost" href="cli-reference">CLI Reference</a>
114119
</div>
115120

0 commit comments

Comments
 (0)