Setup Guide

Telegram Proxy on macOS: Native & Web Methods

Three reliable ways to enable an MTProto proxy on a Mac, including Telegram for Mac, Telegram Lite from the App Store and the web client.

TGFast Editorial Team

MTProto Proxy Engineers · Censorship Circumvention Researchers

Published April 27, 2026 Updated May 15, 2026 8 min read 502 words

Three Telegram clients on macOS

Mac users actually have three official Telegram clients to choose from. The main "Telegram" app (downloaded from telegram.org) is the most feature-complete and offers the cleanest proxy UI. "Telegram Lite" from the Mac App Store is sandboxed, lighter and supports proxies but with a slightly stripped-down settings menu. Finally, the web client (web.telegram.org) works in Safari, Chrome, Firefox and Brave. All three handle MTProto proxies natively.

Setting up the proxy in Telegram for Mac

Open Telegram, click the menu bar app name Telegram → Preferences (or press ⌘,). Switch to the Advanced tab and click Connection. Choose Use Custom Proxy, then click + Add Proxy. In the popover that appears, select MTProto, paste the server, port and secret from a TGFast card, and click Done. The connection switches over instantly.

Get a free TGFast proxy

Browse the live country grid on the home page and tap any card to connect Telegram in one second — no signup, no logs.

Open the fleet

Setting up the proxy in Telegram Lite (App Store)

Telegram Lite's proxy settings live in the same place but with slightly different wording: ⌘, → Privacy → Connection type. The MTProto tab is identical. If you do not see the Connection option, your build is older than the version that introduced MTProto support — update from the App Store.

macOS network privacy and Little Snitch

If you use Little Snitch, Lulu or another outbound firewall, the first time Telegram tries to reach the new proxy host (e.g. your TGFast card hostname) you will get a connection prompt. Allow it permanently. Without explicit allow-listing the proxy will appear to "fail" silently. If you are using macOS Sonoma's built-in Application Firewall, no action is needed — it allows outbound connections by default.

Stay updated

Join @FastTGProxyMT for instant alerts when servers move or new proxies launch.

Join Telegram Channel

Auto-switching by Wi-Fi network

macOS does not natively support per-Wi-Fi proxy switching for Telegram, but you can build it with Shortcuts (macOS 12+). Create an automation triggered by "Wi-Fi Joined" for your office network, with the action Open URL set to one of the tg://proxy?... links. When you connect to that network, macOS will reactivate that specific proxy. This is especially useful if you split your day between a fast home Wi-Fi (use a TGFast proxy) and a more restrictive office network (use a TGFast proxy).

macOS troubleshooting

If the proxy will not connect, the first thing to check is whether your Mac is using a system-wide HTTP/SOCKS proxy from System Settings → Network → Advanced → Proxies. Some VPN apps silently configure these. A system proxy can interfere with the MTProto proxy. Disable any system proxies while testing. Second, if you use a content blocker like Pi-hole or NextDNS, make sure you have not blocked the TGFast hostnames at the DNS level — this is a surprisingly common cause of "instant disconnect" symptoms.

Apple Silicon and energy use

On M1/M2/M3 Macs the proxy has zero meaningful energy impact — Telegram for Mac is a native ARM64 app and the encryption work happens on dedicated hardware. Activity Monitor will show Telegram's "Energy Impact" value at 0.4 or below in idle, identical to running without a proxy. There is no need to disable the proxy to save battery.

Frequently Asked Questions

How long does this setup take from start to finish?

Under 60 seconds for most users. Tap any "Connect Now" button on a TGFast proxy card while reading on your phone, and Telegram will open with a single confirmation prompt — no copying, no typing, no signup. Manual configuration via Settings → Data and Storage takes around two minutes.

Does adding a proxy break end-to-end encryption in my Secret Chats?

No. End-to-end encryption for Secret Chats is performed by your Telegram client and the recipient's client — the proxy server only forwards already-encrypted bytes. The proxy cannot read messages, see attachments, or alter content; it sees only that an MTProto session is in flight.

Will the proxy slow down media downloads or voice calls?

In most regions added latency is 30–80 ms, which is invisible for chat and barely noticeable for voice calls. In censored regions Telegram often feels faster through TGFast because direct connections suffer from forced packet loss; the proxy sidesteps that throttling entirely.

Do I need to reinstall the proxy after a Telegram app update?

No. Proxy configuration is stored in your Telegram account profile, not in the binary, so it survives app updates, OS upgrades, and even reinstalls when you sign in with the same number. The only time you need to re-add it is if you wipe app data or sign out fully.

Can I add more than one TGFast proxy at the same time for failover?

Yes — Telegram supports multiple saved proxies. Add a handful of TGFast servers (our proxy fleet) under Settings → Data and Storage → Proxy and toggle "use a TGFast proxy" on. Telegram will automatically fall back to the next reachable entry if the active one stops responding, giving you near-100% uptime.

Why do I still see "Connecting…" after I added the proxy?

Three usual causes: (1) the wrong port was typed during manual entry — recheck against the value on this page; (2) your firewall/router blocks high-numbered ports — try a different TGFast server; (3) the secret was pasted with an invisible space — copy directly from the card and paste fresh. The one-tap "Connect Now" button avoids all three issues.