tg-ws-proxy/docs/EN/README.linux.md

TG WS Proxy for Linux

Prebuilt Packages

For Debian/Ubuntu, download the TgWsProxy_linux_amd64.deb package from the releases page.

For Arch and Arch-based distributions, packages are available in AUR:

• tg-ws-proxy-bin
• tg-ws-proxy-git
• tg-ws-proxy-cli

# Installation without AUR helper
git clone https://aur.archlinux.org/tg-ws-proxy-bin.git
cd tg-ws-proxy-bin
makepkg -si

# Using AUR helper
paru -S tg-ws-proxy-bin

# For -cli package, run via systemd (8888 — port number; secret can be generated with openssl rand -hex 16)
sudo systemctl start tg-ws-proxy@8888:3075abe65830f0325116bb0416cadf9f

For other distributions, you can use TgWsProxy_linux_amd64 (binary for x86_64).

chmod +x TgWsProxy_linux_amd64
./TgWsProxy_linux_amd64

On first launch, a window will open with instructions. The application runs in the system tray (AppIndicator required).

Updating

When update checks are enabled in settings, the app offers to update itself on startup and installs the new version:

• installed from .deb/.rpm — the new package is downloaded and installed by the package manager (via pkexec, password confirmation required);
• standalone binary — replaced in place if its directory is writable, otherwise also via pkexec.

The downloaded file is checked against the response length and the SHA-256 digest from the release; a corrupted download is never installed. The app restarts automatically after the update.

For AUR packages, pip installs, and non-x86_64 architectures the previous behaviour applies — the release page is opened.

Configuring Telegram Desktop

1. Telegram → Settings → Advanced → Connection type → Proxy
2. Add proxy:
   • Type: MTProto
   • Server: 127.0.0.1 (or your custom address)
   • Port: 1443 (or your custom port)
   • Secret: from settings or logs

Building from Source

Detailed instructions: BuildFromSource.md

pip install -e .
tg-ws-proxy-tray-linux