website/templates/connect.html

55 lines
2.2 KiB
HTML

{% extends "base.html" %}
{% block title %}Connect — echoIRCd{% endblock %}
{% block content %}
<section class="pagehead">
<div class="wrap">
<h1>Connect</h1>
<p>Point any IRC client at the network — or open it right in your browser.</p>
</div>
</section>
<section class="wrap doc">
<div class="doc-block">
<table class="detail">
<tr><th>Server</th><td><code>irc.echoircd.org</code></td></tr>
<tr><th>TLS (recommended)</th><td><code>6697</code></td></tr>
<tr><th>Plaintext</th><td><code>6667</code></td></tr>
<tr><th>Network</th><td>echoiRCd</td></tr>
</table>
<p class="webchat"><a class="btn btn-ghost" href="https://orbit.devtronic.pro">Open the web client &#8599;</a></p>
</div>
<div class="doc-block">
<h2>Client quick-start</h2>
<p>Most clients take a one-line server string; the leading <code>+</code> on the port means TLS.</p>
<pre class="code">/server irc.echoircd.org +6697
/join #echoircd</pre>
<table class="detail">
<tr><th>HexChat</th><td>add <code>irc.echoircd.org/+6697</code> · tick “Use SSL”</td></tr>
<tr><th>WeeChat</th><td><code>/server add echo irc.echoircd.org/6697 -tls</code></td></tr>
<tr><th>irssi</th><td><code>/connect -tls irc.echoircd.org 6697</code></td></tr>
<tr><th>mIRC</th><td><code>/server irc.echoircd.org +6697</code></td></tr>
</table>
</div>
<div class="doc-block">
<h2>Register your nick</h2>
<p>Registering lets you keep your nickname, found channels, and log in with SASL.</p>
<pre class="code">/msg NickServ REGISTER &lt;password&gt; &lt;email&gt;
/msg NickServ IDENTIFY &lt;password&gt;</pre>
</div>
<div class="doc-block">
<h2>Log in with a key (ECDSA)</h2>
<p>Sign a server challenge with a NIST&nbsp;P-256 key instead of sending a password — nothing
secret crosses the wire.</p>
<pre class="code"># generate a key, read its public half
ecdsatool keygen ~/.ecdsa.pem
ecdsatool pubkey ~/.ecdsa.pem
# store it, then pick ECDSA-NIST256P-CHALLENGE for SASL
/msg NickServ SET PUBKEY &lt;printed-public-key&gt;</pre>
<p class="note">Point your client's SASL settings at the same key file.</p>
</div>
</section>
{% endblock %}