Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Flowseal/tg-ws-proxy/llms.txt

Use this file to discover all available pages before exploring further.

TG WS Proxy is a local MTProto proxy that routes Telegram Desktop traffic over WebSocket connections. On Linux it is available as a .deb package for Debian-based distributions, through the AUR for Arch Linux users, and as a standalone binary for every other distribution. A headless CLI package is also provided for server or minimal-desktop setups.

​
Installation

Download TgWsProxy_linux_amd64.deb from the releases page, then install it with dpkg:
sudo dpkg -i TgWsProxy_linux_amd64.deb
After installation, launch TG WS Proxy from your application menu or run tg-ws-proxy-tray-linux in a terminal.
The tray app requires AppIndicator support in your desktop environment. GNOME users may need the AppIndicator and KStatusNotifierItem Support extension. KDE Plasma, XFCE, and most other DEs include AppIndicator support out of the box.

​
systemd Service (CLI Package)

The tg-ws-proxy-cli AUR package registers a systemd template unit that lets you run the proxy as a background service. The instance name encodes the port and secret separated by a colon: 
# Start the proxy on port 8888 with the given secret
sudo systemctl start tg-ws-proxy@8888:3075abe65830f0325116bb0416cadf9f

# Enable autostart on boot
sudo systemctl enable tg-ws-proxy@8888:3075abe65830f0325116bb0416cadf9f
Generate a random secret with: 
openssl rand -hex 16
Check service status and logs with: 
sudo systemctl status tg-ws-proxy@8888:3075abe65830f0325116bb0416cadf9f
journalctl -u tg-ws-proxy@8888:3075abe65830f0325116bb0416cadf9f -f

​
Connect Telegram Desktop

​
Automatic

When the tray app is running, click its icon in the system tray and choose Open in Telegram. Telegram Desktop will open and prompt you to enable the proxy.

​
Manual

1

Open Telegram proxy settings

In Telegram Desktop go to Settings → Advanced → Connection type, then select Use custom proxy.
2

Add a new proxy

Click Add proxy and fill in the fields:
  • Type: MTProto
  • Server: 127.0.0.1
  • Port: 1443
  • Secret: copy from the first-launch window, the Settings dialog, or the log file
3

Save and connect

Click Save, select the new proxy entry, and click Enable.
If you changed the default host or port (for example when using the CLI with --port), substitute those values for 127.0.0.1 and 1443 above.

Build docs developers (and LLMs) love

Get started for freeTalk to us