Files
zulip/help/connect-through-a-proxy.md
Shubham Padia a54d247111 help: Use 1. for numbered lists everywhere.
The conversion script for help-beta assumes that all items in a numbered
list start with 1. which was a wrong assumption. This commit attempts to
fix that. We are not introducing any lint step to tackle this since it
will be easy to just check for this again before the cutover happens.
We do not change this for `numbered-list-examples.md` since that example
shows how the current numbered lists work and we might still want to
show that. We can decide what to do with that file once the time of
cutover arrives.
2025-06-23 09:48:43 -07:00

2.4 KiB

Connect through a proxy

Some corporate and university networks may require you to connect to Zulip via a proxy.

Web

Zulip uses your browser's default proxy settings. To set a custom proxy just for Zulip, check your browser's instructions for setting a custom proxy for a single website.

Desktop

{start_tabs}

{tab|system-proxy-settings}

{!desktop-sidebar-settings-menu.md!}

  1. Select the Network tab.

  2. Click Use system proxy settings.

  3. Restart the Zulip desktop app.

{tab|custom-proxy-settings}

{!desktop-sidebar-settings-menu.md!}

  1. Select the Network tab.

  2. Click Manual proxy configuration.

  3. Either enter a URL for PAC script, or fill out Proxy rules and Proxy bypass rules.

  4. Click Save changes.

{end_tabs}

Additional tips for custom proxy settings

In most corporate environments, your network administrator will provide a URL for the PAC script.

The second most common configuration is that your network administrator has set up a proxy server for accessing the public internet, but URLs on the local network must be accessed directly. In that case set Proxy rules to the URL of the proxy server (it may look something like http://proxy.example.edu:port), and Proxy bypass rules to cover local URLs (it may look something like *.example.edu,10.0.0.0/8).

If either of those apply, you can skip the rest of this guide. If not, we document the syntax for Proxy rules and Proxy bypass rules below.

Proxy rules

A semicolon-separated list of protocolRules.

protocolRule -> [<protocol>"="]<URLList>
protocol -> "http" | "https" | "ftp" | "socks"
URLList -> comma-separated list of URLs, ["direct://"]

Some examples:

  • http=http://foo:80;ftp=http://bar:1080 - Use proxy http://foo:80 for http:// URLs, and proxy http://bar:1080 for ftp:// URLs.
  • http://foo:80 - Use proxy http://foo:80 for all URLs.
  • http://foo:80,socks5://bar,direct:// - Use proxy http://foo:80 for all URLs, failing over to socks5://bar if http://foo:80 is unavailable, and after that using no proxy.
  • http=http://foo;socks5://bar - Use proxy http://foo for http:// URLs, and use socks5://bar for all other URLs.

Proxy bypass rules

A comma-separated list of URIs. The URIs can be hostnames, IP address literals, or IP ranges in CIDR notation. Hostnames can use the * wildcard. Use <local> to match any of 127.0.0.1, ::1, or localhost.