Skip to content

Commit ff82309

Browse files
authored
Merge pull request #610 from inejge/readme-proxy
Add HTTP proxy documentation to README
2 parents 5394c48 + 172442d commit ff82309

File tree

1 file changed

+25
-0
lines changed

1 file changed

+25
-0
lines changed

README.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -369,6 +369,31 @@ is invoked for a custom toolchain and it is not available, `rustup`
369369
will attempt to use `cargo` from one of the release channels*,
370370
preferring 'nightly', then 'beta' or 'stable'.
371371

372+
## Working with HTTP proxies
373+
374+
Enterprise networks often don't have direct outside HTTP access, but enforce
375+
the use of HTTP proxies. If you're on such a network, you can request that
376+
rustup uses a proxy by setting its URL in the environment. In most cases,
377+
setting `http_proxy` should be sufficient. On a Unix-like system with a
378+
shell like __bash__ or __zsh__, you could use:
379+
380+
```
381+
export http_proxy=http://proxy.example.com:8080
382+
```
383+
384+
On Windows, the command would be:
385+
386+
```
387+
set http_proxy=http://proxy.example.com:8080
388+
```
389+
390+
If you need a more complex setup, rustup supports the convention used by
391+
the __curl__ program, documented in the ENVIRONMENT section of
392+
[its manual page][curlman].
393+
394+
[curlman]: https://curl.haxx.se/docs/manpage.html
395+
396+
372397
## Examples
373398

374399

0 commit comments

Comments
 (0)