diff --git a/i2p2www/pages/site/docs/applications/irc.html b/i2p2www/pages/site/docs/applications/irc.html new file mode 100644 index 00000000..79af9bef --- /dev/null +++ b/i2p2www/pages/site/docs/applications/irc.html @@ -0,0 +1,235 @@ +{% extends "global/layout.html" %} +{% block title %}{% trans %}Configuring IRC Software{% endtrans %}{% endblock %} +{% block lastupdated %}2020-11{% endblock %} +{% block accuratefor %}0.9.47{% endblock %} +{% block content %} +

{% trans %}IRC Software{% endtrans %}

+ + + +

{% trans %}Clients{% endtrans %}

+ +

{% trans %} There are many IRC clients that can be used with I2P. In +fact, all IRC clients can be connected to the Irc2P Service by connecting +them to the IRC Tunnel.{% endtrans %}

+ + + +

Check the IRC tunnel

+

{% trans %}To configure any IRC client to chat on Irc2P, first, make sure that +your IRC tunnel is available. Visit the Hidden Services Manager +and look for Irc2P in your "Client Tunnels" section. If the "Status" indicator on +the right-hand side is yellow or green, your Irc2P tunnel is ready and you should +proceed to the next step.{% endtrans %}

+ + + +

{% trans %}Any IRC client can be connected to this IRC tunnel, but detailed +instructions for several popular clients are provided below.{% endtrans %}

+ + +

Pidgin

+

{% trans %}Pidgin is a very popular Instant Messaging client with built-in IRC +support. It is also possible to use it with many other kinds of chat service, and +it supports using multiple accounts at once and has a variety of plugin-ins. There +is a similar application for OSX called "Adium." The instructions for Pidgin are +similar in Adium. +{% endtrans %}

+ + + +

{% trans %}After launching Pidgin, you should see a "Buddy List" window. From +that window, open the "Accounts" menu from the toolbar. Select "Manage Accounts" to +begin configuring your I2P account.{% endtrans %}

+ + + +

{% trans %}Click the "Add" button. In the window that opens, select "IRC" under +"Protocol," and set the "Host" to 127.0.0.1. Then pick a username and password. IRC +does not require you to register a nickname to join, but you may if you wish, after +you connect to Irc2P.{% endtrans %}

+ + + +

{% trans %}Navigate to the "Advanced" tab and set the "Port" field to 6668 and +make sure that SSL is disabled, since your tunnel has encryption provided +by I2P.{% endtrans %}

+ + + + +

XChat

+

{% trans %}Open the Server List menu of XChat and click the "Add" button.{% endtrans %}

+ + + +

{% trans %}Create a new network named "Irc2P" to configure for I2P IRC. Click +the "Edit" button on the right-hand side.{% endtrans %}

+ + + +

{% trans %}Change the value in "Servers" from the default to `localhost/6669`, +and configure the default channels you want to join. I suggest #i2p and #i2p-dev +{% endtrans %}

+ + + +

{% trans %}Close the "Edit Server" window from to return to the Server List +page and click "Connect" to join I2PRC.{% endtrans %}

+ + + + +

Thunderbird

+

{% trans %}Click on the "Chat" button in the toolbar at the top of the +Thunderbird window.{% endtrans %}

+ + + +

{% trans %}Click the get started button to begin setting up Irc2P.{% endtrans %}

+ + + +

{% trans %}In the first step, select "IRC" for your network type.{% endtrans %}

+ + + +

{% trans %}Choose a nickname and set your IRC Server to 127.0.0.1, but do not +set a port.{% endtrans %}

+ + + +

{% trans %}Set a password if you want.{% endtrans %}

+ + + +

{% trans %}Configure the IRC Server with an alias like "Irc2P" and set the +port to 6668.{% endtrans %}

+ + + +

{% trans %}If your summary looks like this, then you're ready to connect +with Irc2P.{% endtrans %}

+ + + + +

Revolution IRC

+

{% trans %}Revolution IRC is an easy to use IRC client for Android. It's able to +handle multiple accounts on multiple services, so you can use it for Irc2P and for +your non-I2P IRC networks as well.{% endtrans %}

+ +

{% trans %}Click the "Add Server" button(Shaped like this: `+`) in the corner +to get started configuring Revolution IRC for I2P.{% endtrans %}

+ + + +

{% trans %}Fill in the server name, change the address to "127.0.0.1" and the +port to 6668.{% endtrans %}

+ + + +

{% trans %}Give yourself a nickname and configure some channels to automatically +join.{% endtrans %}

+ + + + +

Dispatch

+

{% trans %}Dispatch is a stable, self-hosted IRC client with a web interface. It +has native I2P configuration available by communicating over the{% endtrans %} SAM v3 API.

+ +

{% trans %}Dispatch is configured with a file called `config.toml`, which you can +configure the common settings.{% endtrans %}

+ +

{% trans %} {% endtrans %}

+

+# Defaults for the client connect form
+[defaults]
+name = "myinvisibleirc.i2p"
+host = "anircservergoeshere.b32.i2p"
+port = 6667
+channels = [
+  "#i2p",
+  "#i2p-dev"
+]
+server_password = ""
+ssl = false
+
+ + +

{% trans %}Servers{% endtrans %}

+ + + +

Eris

+

{% trans %}Eris is an easy-to-configure IRC server with self-configuring support +for I2P. If you want to run a private IRC server it's one of the easiest ways.{% endtrans %}

+ +

{% trans %} This is a valid configuration of the Eris IRC server, but it uses a +default password for the admin account(admin). You should change the operator.admin.password +and account.admin.password before deploying to a real service.{% endtrans %}

+ +

+mutex: {}
+network:
+  name: Local
+server:
+  password: ""
+  listen: []
+  tlslisten: {}
+  i2plisten:
+    invisibleirc:
+      i2pkeys: iirc
+      samaddr: 127.0.0.1:7656
+  log: ""
+  motd: ircd.motd
+  name: myinvisibleirc.i2p
+  description: Hidden IRC Services
+operator:
+  admin:
+    password: JDJhJDA0JE1vZmwxZC9YTXBhZ3RWT2xBbkNwZnV3R2N6VFUwQUI0RUJRVXRBRHliZVVoa0VYMnlIaGsu
+account:
+  admin:
+    password: JDJhJDA0JGtUU1JVc1JOUy9DbEh1WEdvYVlMdGVnclp6YnA3NDBOZGY1WUZhdTZtRzVmb1VKdXQ5ckZD
+www: 
+  listen: []
+  tlslisten: {}
+  i2plisten:
+    i2pinfoirc:
+      i2pkeys: iircwww
+      samaddr: "127.0.0.1:7656"
+templatedir: lang
+
+ +{% endblock %} diff --git a/i2p2www/static/images/irc/pidgin-irc-0.png b/i2p2www/static/images/irc/pidgin-irc-0.png new file mode 100644 index 00000000..35887455 Binary files /dev/null and b/i2p2www/static/images/irc/pidgin-irc-0.png differ diff --git a/i2p2www/static/images/irc/pidgin-irc-1.png b/i2p2www/static/images/irc/pidgin-irc-1.png new file mode 100644 index 00000000..68fc5c79 Binary files /dev/null and b/i2p2www/static/images/irc/pidgin-irc-1.png differ diff --git a/i2p2www/static/images/irc/pidgin-irc-2.png b/i2p2www/static/images/irc/pidgin-irc-2.png new file mode 100644 index 00000000..61bc3993 Binary files /dev/null and b/i2p2www/static/images/irc/pidgin-irc-2.png differ diff --git a/i2p2www/static/images/irc/pidgin-irc-3.png b/i2p2www/static/images/irc/pidgin-irc-3.png new file mode 100644 index 00000000..16132c36 Binary files /dev/null and b/i2p2www/static/images/irc/pidgin-irc-3.png differ diff --git a/i2p2www/static/images/irc/revolution-irc-0.png b/i2p2www/static/images/irc/revolution-irc-0.png new file mode 100644 index 00000000..ad813236 Binary files /dev/null and b/i2p2www/static/images/irc/revolution-irc-0.png differ diff --git a/i2p2www/static/images/irc/revolution-irc-1.png b/i2p2www/static/images/irc/revolution-irc-1.png new file mode 100644 index 00000000..03c27097 Binary files /dev/null and b/i2p2www/static/images/irc/revolution-irc-1.png differ diff --git a/i2p2www/static/images/irc/revolution-irc-2.png b/i2p2www/static/images/irc/revolution-irc-2.png new file mode 100644 index 00000000..56739860 Binary files /dev/null and b/i2p2www/static/images/irc/revolution-irc-2.png differ diff --git a/i2p2www/static/images/irc/thunderbird-irc-0.png b/i2p2www/static/images/irc/thunderbird-irc-0.png new file mode 100644 index 00000000..f933be0b Binary files /dev/null and b/i2p2www/static/images/irc/thunderbird-irc-0.png differ diff --git a/i2p2www/static/images/irc/thunderbird-irc-1.png b/i2p2www/static/images/irc/thunderbird-irc-1.png new file mode 100644 index 00000000..32b4455b Binary files /dev/null and b/i2p2www/static/images/irc/thunderbird-irc-1.png differ diff --git a/i2p2www/static/images/irc/thunderbird-irc-2.png b/i2p2www/static/images/irc/thunderbird-irc-2.png new file mode 100644 index 00000000..94ef92fd Binary files /dev/null and b/i2p2www/static/images/irc/thunderbird-irc-2.png differ diff --git a/i2p2www/static/images/irc/thunderbird-irc-3.png b/i2p2www/static/images/irc/thunderbird-irc-3.png new file mode 100644 index 00000000..c8daa639 Binary files /dev/null and b/i2p2www/static/images/irc/thunderbird-irc-3.png differ diff --git a/i2p2www/static/images/irc/thunderbird-irc-4.png b/i2p2www/static/images/irc/thunderbird-irc-4.png new file mode 100644 index 00000000..b00acb6f Binary files /dev/null and b/i2p2www/static/images/irc/thunderbird-irc-4.png differ diff --git a/i2p2www/static/images/irc/thunderbird-irc-5.png b/i2p2www/static/images/irc/thunderbird-irc-5.png new file mode 100644 index 00000000..b2781da5 Binary files /dev/null and b/i2p2www/static/images/irc/thunderbird-irc-5.png differ diff --git a/i2p2www/static/images/irc/thunderbird-irc-6.png b/i2p2www/static/images/irc/thunderbird-irc-6.png new file mode 100644 index 00000000..1c8a441d Binary files /dev/null and b/i2p2www/static/images/irc/thunderbird-irc-6.png differ diff --git a/i2p2www/static/images/irc/tuncheck-irc-all.png b/i2p2www/static/images/irc/tuncheck-irc-all.png new file mode 100644 index 00000000..c6eb1d96 Binary files /dev/null and b/i2p2www/static/images/irc/tuncheck-irc-all.png differ diff --git a/i2p2www/static/images/irc/xchat-irc-0.png b/i2p2www/static/images/irc/xchat-irc-0.png new file mode 100644 index 00000000..493d9b4f Binary files /dev/null and b/i2p2www/static/images/irc/xchat-irc-0.png differ diff --git a/i2p2www/static/images/irc/xchat-irc-1.png b/i2p2www/static/images/irc/xchat-irc-1.png new file mode 100644 index 00000000..9f5a9cba Binary files /dev/null and b/i2p2www/static/images/irc/xchat-irc-1.png differ diff --git a/i2p2www/static/images/irc/xchat-irc-2.png b/i2p2www/static/images/irc/xchat-irc-2.png new file mode 100644 index 00000000..4568727c Binary files /dev/null and b/i2p2www/static/images/irc/xchat-irc-2.png differ diff --git a/i2p2www/static/images/irc/xchat-irc-3.png b/i2p2www/static/images/irc/xchat-irc-3.png new file mode 100644 index 00000000..2fd3f29c Binary files /dev/null and b/i2p2www/static/images/irc/xchat-irc-3.png differ