How to Add a Telegram Proxy on Desktop (Windows, Mac, Linux 2026)

Why Use a Proxy on Desktop

If you're reading this from Windows, macOS, or Linux, chances are Telegram stopped loading on your computer — even though it might still work on your phone. That's because desktop networks often have their own restrictions, separate from mobile carriers. Users in Iran, China, Russia, Pakistan, the UAE, and parts of Iraq routinely hit Telegram blocks on their home broadband, office Wi-Fi, or university LAN. A Telegram proxy is the fastest way to get back online without installing any extra software.

The most common reasons desktop users need a proxy include national ISP-level blocks, corporate firewalls that classify Telegram as "non-work traffic," and university networks that throttle or ban messengers to save bandwidth. Hotels, airports, and coworking spaces often do the same.

The good news: unlike a VPN, a Telegram proxy only routes Telegram's traffic. You don't need to install a VPN client, grant admin privileges, or change any system-wide network settings. Telegram Desktop has proxy support built directly into the app, and ECHO Proxy offers a continuously refreshed list of free MTProxy and SOCKS5 servers you can connect to in one click. This guide walks through every method — from browser one-click links to manual setup — for Windows, macOS, Linux, and Telegram Web.

Method 1: One-Click via Browser

This is the fastest method and works identically on every desktop OS. It takes about ten seconds.

1. Open any browser — Chrome, Firefox, Safari, or Edge.
2. Visit telegramvpn.org.
3. Browse the live list and pick a proxy with low ping. Click the blue Connect button on any proxy card.
4. Your browser will show a small popup: "Open Telegram Desktop?" (the exact wording depends on your browser).
5. Click Open or Open Link.
6. Telegram Desktop launches (or jumps to the foreground if already running) and displays a confirmation dialog: "Enable this proxy?".
7. Click Enable. You're connected in seconds.

Once enabled, Telegram Desktop shows a small shield icon near the top of the chat list, confirming traffic is being routed through the proxy. If the proxy ever stops working, simply return to ECHO Proxy and click Connect on a different one — Telegram Desktop will replace the previous entry or add a new one you can toggle between.

This method works on Windows 7 through 11, macOS Sierra through Sonoma and later, and all Linux distributions with Telegram Desktop installed. No command line, no configuration files, no restarts.

Method 2: Manual Setup in Telegram Desktop

If the browser link doesn't trigger Telegram (for example, on a locked-down corporate PC where the protocol handler is disabled), you can enter the proxy details by hand. The UI is identical on Windows, macOS, and Linux.

1. Open Telegram Desktop. If you don't have it yet, download it from telegram.org/apps.
2. Click the ☰ menu button in the top-left corner of the window.
3. Click Settings. (Keyboard shortcut: Ctrl + , on Windows/Linux, Cmd + , on Mac — this opens Settings instantly from anywhere in the app.)
4. Click Advanced.
5. Under the "Connection type" section, click Connection type.
6. Select Use custom proxy.
7. Click Add Proxy.
8. Select the proxy protocol: MTProto (recommended) or SOCKS5.
9. Enter the Server, Port, and (for MTProto) the Secret key. For SOCKS5, enter Username and Password only if the server requires them.
10. Click Save.
11. Tick the checkbox next to the newly added proxy to enable it.

Here's what the values look like for an MTProto proxy from ECHO Proxy:

Type:    MTProto
Server:  proxy.example.com
Port:    443
Secret:  ee0123456789abcdef0123456789abcdef

And for SOCKS5:

Type:      SOCKS5
Server:    socks.example.com
Port:      1080
Username:  (optional)
Password:  (optional)

After saving, Telegram Desktop immediately tries to connect through the new proxy. If successful, the proxy row shows a green dot and a millisecond ping time. You can add as many proxies as you like and switch between them from the same screen — useful if one server goes down. Copy values straight from the proxy detail pages on ECHO Proxy to avoid typos.

Method 3: Telegram Web (Browser)

A lot of users ask how to add a telegram web proxy at web.telegram.org. The honest answer: Telegram Web does not have a built-in proxy setting. It is a pure browser app and uses whatever network path the browser uses. That leaves a few workarounds:

• Workaround 1 — Browser extension: Install a SOCKS5-capable extension such as FoxyProxy Standard (Chrome/Firefox) and point it at a SOCKS5 server. The extension routes only browser traffic through the proxy, so Telegram Web will use it too.
• Workaround 2 — System proxy: Set a SOCKS5 server in Windows (Settings → Network → Proxy), macOS (System Settings → Network → Proxies), or Linux (GNOME/KDE network settings). This affects all apps, which may or may not be what you want.
• Workaround 3 — Install Telegram Desktop: It's a 50 MB download, it's more reliable, and it has native proxy support. For most users this is the easiest path.

Our recommendation: skip the web client and use Telegram Desktop with an ECHO Proxy MTProto server. You'll get better performance, notification support, and proxy traffic obfuscation that Telegram Web simply cannot offer.

Windows-Specific Notes

Telegram Desktop on Windows uses its own internal proxy settings, which are completely separate from the Windows system proxy. Setting a proxy inside Telegram will not affect Edge, Chrome, or any other application. Conversely, a system-wide Windows proxy will not automatically flow into Telegram — you must configure it inside the app.

Telegram Desktop runs on Windows 7, 8, 8.1, 10, and 11. It works on both 32-bit and 64-bit builds, and the portable version behaves identically to the installer version. You do not need administrator rights to add or enable a proxy — everything is stored in your user profile.

macOS-Specific Notes

On macOS, the settings layout is identical to Windows. Open Telegram, press Cmd + , to jump straight into Settings, then go to Advanced → Connection type. The same MTProto and SOCKS5 options are available.

Telegram Desktop runs on macOS 10.12 Sierra and later, and is fully native on Apple Silicon (M1, M2, M3, and newer chips). You do not need Homebrew, Xcode, or any developer tools. The App Store version and the direct download from telegram.org both support proxies — the App Store version does not strip this functionality.

Linux-Specific Notes

Telegram Desktop on Linux is one of the most capable Telegram clients available. It runs on all major distributions — Ubuntu, Debian, Fedora, Arch, openSUSE, and their derivatives. Both the Flatpak build (from Flathub) and the Snap build fully support MTProto and SOCKS5 proxies — no sandbox permissions need changing.

The UI is identical to Windows and Mac: three-line menu, Settings, Advanced, Connection type. No terminal commands are required. If you prefer the command line, you can also launch Telegram with an environment variable to set a SOCKS5 proxy globally, but 99% of users should just use the in-app settings with an ECHO Proxy server.

Troubleshooting

Most desktop proxy problems fall into a handful of patterns:

• "Connection failed" or "Proxy unavailable": The server is offline or overloaded. Return to telegramvpn.org and pick another proxy. ECHO Proxy tests servers every 30 seconds, so the "Online" badge is always current.
• Desktop won't open from browser link: Telegram Desktop is probably not installed, or the tg:// protocol handler isn't registered. Install Telegram Desktop from telegram.org, launch it once, then try the link again.
• Proxy works on phone but not desktop: Your corporate or university firewall may be blocking the specific port. Try a different proxy — preferably one on port 443, which firewalls rarely block because it's the same port as HTTPS.
• Slow on desktop: The server is overloaded or geographically far away. Pick a proxy with ping under 150ms and an uptime above 95%. See our Telegram proxy not working guide for deeper diagnosis.
• Can't find "Advanced" settings: You're on a very old build. Update Telegram Desktop to the latest version — go to the ☰ menu → Settings → About, or reinstall from telegram.org.
• Proxy keeps disconnecting: Sometimes it's the secret key being copied with trailing whitespace. Re-paste it carefully, or use the one-click Connect button to avoid manual entry entirely.

For mobile users also having issues, check our Android and iOS guides: Android setup and iPhone setup.

Frequently Asked Questions