mirror of https://github.com/zulip/zulip.git synced 2025-10-23 04:52:12 +00:00

Files

Lauryn Menard dedea23745 help-docs: Move help center documentation to top level directory.

These files are not Jinja2 templates, so there's no reason that they needed
to be inside `templates/zerver`. Moving them to the top level reflects their
importance and also makes it feel nicer to work on editing the help center content, 
without it being unnecessary buried deep in the codebase.

2023-01-25 14:08:29 -08:00

2.4 KiB

Raw Blame History

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!}

Select the Network tab.
Click Use system proxy settings.
Restart the Zulip desktop app.

{tab|custom-proxy-settings}

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

Select the Network tab.
Click Manual proxy configuration.
Either enter a URL for PAC script, or fill out Proxy rules and Proxy bypass rules.
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.

2.4 KiB Raw Blame History