From 90bbcf1bcf0d953a8bdb17f6bbf77a712364dbce Mon Sep 17 00:00:00 2001 From: tobi <31960611+tsmethurst@users.noreply.github.com> Date: Tue, 22 Nov 2022 17:51:51 +0100 Subject: [PATCH] [docs] Document http/s/socks5 proxy use (#1118) --- docs/installation_guide/advanced.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/installation_guide/advanced.md b/docs/installation_guide/advanced.md index d093ac9ca..29814bc90 100644 --- a/docs/installation_guide/advanced.md +++ b/docs/installation_guide/advanced.md @@ -156,3 +156,11 @@ Then we get the following response: ``` In the above response, note that the `subject` of the response contains the desired account-domain of `superseriousbusiness.org`, whereas the links contain the actual host value of `gts.superseriousbusiness.org`. + +## Can I make my GoToSocial instance use a proxy (http, https, socks5) for outgoing requests? + +Yes! GoToSocial supports canonical environment variables for doing this: `HTTP_PROXY`, `HTTPS_PROXY` and `NO_PROXY` (or the lowercase versions thereof). `HTTPS_PROXY` takes precedence over `HTTP_PROXY` for https requests. + +The http client that GoToSocial uses will be initialized with the appropriate proxy. + +The environment values may be either a complete URL or a `host[:port]`, in which case the "http" scheme is assumed. The schemes "http", "https", and "socks5" are supported.