Update Tor federation guide

README.md

@@ -11,8 +11,9 @@ Features:
 - Content subscription service. Subscriptions provide a way to receive monthly payments from subscribers and to publish private content made exclusively for them.
   - Supported payment methods: [Monero](https://www.getmonero.org/get-started/what-is-monero/) and [ERC-20](https://ethereum.org/en/developers/docs/standards/tokens/erc-20/) tokens (on Ethereum and other EVM-compatible blockchains).
 - [Sign-in with a wallet](https://eips.ethereum.org/EIPS/eip-4361).
-- Account migrations (from one server to another). Identity can be detached from the server.
 - Donation buttons.
+- Account migrations (from one server to another). Identity can be detached from the server.
+- Federation over Tor.
 
 Follow: [@mitra@mitra.social](https://mitra.social/@mitra)
 
@@ -102,6 +103,10 @@ systemctl start mitra
 
 An HTTP server will be needed to handle HTTPS requests. See the example of [nginx configuration file](./contrib/mitra.nginx).
 
+### Tor federation
+
+See [guide](./docs/onion.md).
+
 ### Monero
 
 Install Monero node or choose a [public one](https://monero.fail/).

docs/onion.md

@@ -1,4 +1,6 @@
-# Tor instance
+# Tor federation
+
+## Tor-only instance
 
 Install Tor.
 
@@ -25,3 +27,16 @@ Restart the Tor service. Inside the `HiddenServiceDir` directory find the `hostn
 Start Mitra.
 
 For more information about running onion services, visit https://community.torproject.org/onion-services/setup/
+
+## Clearnet + Tor
+
+Clearnet instances can federate with Tor-only instances.
+
+Add the following block to Mitra configuration file:
+
+```yaml
+federation:
+  onion_proxy_url: 'socks5h://127.0.0.1:9050'
+```
+
+Where `127.0.0.1:9050` is the address and the port where Tor proxy is listening.