From e49c8588c68ecfd96787d5319a768c5ac3f2b58e Mon Sep 17 00:00:00 2001 From: serinko <97586125+serinko@users.noreply.github.com> Date: Fri, 18 Aug 2023 14:03:43 +0200 Subject: [PATCH] initiated telegram tutorial --- .../dev-portal/src/tutorials/telegram.md | 41 +++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 documentation/dev-portal/src/tutorials/telegram.md diff --git a/documentation/dev-portal/src/tutorials/telegram.md b/documentation/dev-portal/src/tutorials/telegram.md new file mode 100644 index 0000000000..1965fceea4 --- /dev/null +++ b/documentation/dev-portal/src/tutorials/telegram.md @@ -0,0 +1,41 @@ +# Telegram NymConnect Integration + +*This is a shortened version of a [Nym Community post](https://blog.nymtech.net/how-to-use-telegram-in-iraq-with-nymconnect-106a3b8dd050) written by Saliveja.* + +The purpose of the following manual is not to promote Telegram but so people can use it with the Nym mixnet if they wish to, should a situation ask for that. This privacy-enhances Telegram at the network level and allows users to access the application from locations like where the application was banned. + +See also: [Element (Matrix) over the Nym mixnet](./matrix.md): private, decentralised and secure messaging. + +## Setup & Run + +Here’s how to configure Telegram with NymConnect: + +1. Download and install NymConnect ().** + For more releases, check out [Github](https://github.com/nymtech/nym/tags). NymConnect is available for Linux, Windows, and MacOS. + On Linux make sure NymConnect is executable. Opening a terminal in the same directory and run: + ```sh + chmod +x ./.AppImage + ``` +2. **Start NymConnect** + Telegram is added to NymConnect by default. +3. **Click connect - the host and port will now be displayed.** +4. **Click on host or port to copy** the value to the clipboard. +5. **Open the Telegram proxy settings.** + Linux: Telegram -> Settings -> Advanced -> Connection type -> Use custom proxy + MacOS: Telegram -> Settings -> Advanced -> Data & Storage -> Connection Type -> Use custom Proxy + Windows: Telegram -> Settings -> Data and Storage -> Use proxy +6. **Add a proxy** with the Add proxy button. +7. **Select SOCKS5** and make sure the port details are the same as those generated by NymConnect. Alternatively, follow this link: https://t.me/socks?server=127.0.0.1&port=1080 +8. **Save the proxy settings** in Telegram. +9. **Telegram is now running through the Nym Mixnet and is privacy-enhanced!** + This allows you to connect from regions which blocked Telegram. +10. Note if you remain idle on Telegram for a while you might lose connectivity and your messages might not get through via SOCKS5 proxy. If that happens reconnect your NymConnect and reset the proxy again. + + +Follow this [video](https://youtu.be/quj8H2qeOwY?t=97) to see the steps on Telegram setup. + + +**Now your Telegram runs over NymConnect.** + +NymConnect is currently available for several applications and service providers. Support for more apps is on the way. For any bug reports or feedback please reach out to us on Telegram or our [Discord](http://discord.gg/nym) server. +