From 2a5cd2d9d5a2b5299a3dd6036a52854bc2be943d Mon Sep 17 00:00:00 2001
From: Crimekillz <crimekillz@161.sh>
Date: Sat, 30 Mar 2024 16:49:53 +0100
Subject: [PATCH] =?UTF-8?q?docs/federate-via-onion-i2p.md=20hinzugef=C3=BC?=
 =?UTF-8?q?gt?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/federate-via-onion-i2p.md | 71 ++++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)
 create mode 100644 docs/federate-via-onion-i2p.md

diff --git a/docs/federate-via-onion-i2p.md b/docs/federate-via-onion-i2p.md
new file mode 100644
index 000000000..71b4811e3
--- /dev/null
+++ b/docs/federate-via-onion-i2p.md
@@ -0,0 +1,71 @@
+# Quick example of federating with Tor instances from clearnet
+
+![figure1](https://gist.githubusercontent.com/hcmiya/e635b31ae8c4b33d903f224ddbc45197/raw/84bb5c81f9681837920cbf6d0b05cb7c5513c565/002-clearnet-tor.png)
+
+## Install and configure Tor / Privoxy
+
+```console
+# pacman -S privoxy tor
+```
+
+Append following to `/etc/tor/torrc`
+```text
+SOCKSPort 127.0.0.1 9050
+```
+
+Append following to `/etc/privoxy/config`
+```text
+forward-socks5t .onion 127.0.0.1:9050 . # remember '.' on the end
+```
+
+Then restart tor and privoxy.
+
+## Configure TrashPoss
+
+Append following to `.env`
+```text
+ALLOW_ACCESS_TO_HIDDEN_SERVICE=true
+```
+
+Uncomment the following line and set as follows:
+```text
+# Proxy for HTTP/HTTPS
+proxy: http://127.0.0.1:8118
+```
+
+Then restart TrashPoss services. Try to search users on the tor instance e.g. `@root@nq5jmc5rsyo4fiph.onion`, `@notjeff@pleroma.oniichanylo2tsi4.onion`, `@xps2@5z5ce433e2yp73jqm3yxmyh2yvcn33venhnm5trqde6uwjysxyy3gbad.onion`, etc.
+
+# I2P support
+
+![figure2](https://gist.githubusercontent.com/hcmiya/e635b31ae8c4b33d903f224ddbc45197/raw/84bb5c81f9681837920cbf6d0b05cb7c5513c565/003-clearnet-tor-i2p.png)
+
+## Install and configure I2P / Provoxy
+
+If you are using Arch Linux, just type following:
+
+```console
+# pacman -S i2p
+```
+
+Otherwise see install documentation in official site: https://geti2p.net/en/download
+
+After the installation and running I2P, You need to create new SOCKS proxy. **Using HTTP proxy instead of SOCKS proxy does not work well**. 
+
+1. Open I2P router config by brower at http://127.0.0.1:7657/i2ptunnelmgr
+2. Create "New client tunnel" whose type is "SOCKS 4/4a/5" from bottom of the page.
+3. Configure new proxy as following:
+    ```text
+    Auto Start Tunnel: True
+    Access Point: Port: 9049, Reachable by: 127.0.0.1
+    ```
+
+Append following to `/etc/privoxy/config`
+```text
+forward-socks5 .i2p 127.0.0.1:9049 . # remember '.' on the end
+```
+
+Then restart I2P client tunnel and privoxy. Try to search users on the I2P instance e.g. `@root@5hftbbffiohmyugvc6vypyqhi6tl2yxo6wvyscybvv5c57pva3iq.b32.i2p`
+
+# See also
+
+* [Darknet連合対応インスタンスの一覧 - マストドン日本語ウィキ](https://ja.mstdn.wiki/Darknet%E9%80%A3%E5%90%88%E5%AF%BE%E5%BF%9C%E3%82%A4%E3%83%B3%E3%82%B9%E3%82%BF%E3%83%B3%E3%82%B9%E3%81%AE%E4%B8%80%E8%A6%A7)
\ No newline at end of file