diff options
| author | hagbard <vyosdev@derith.de> | 2019-10-18 12:12:49 -0700 |
|---|---|---|
| committer | hagbard <vyosdev@derith.de> | 2019-10-18 12:12:49 -0700 |
| commit | add0a00124c364f17ad3bb86ef8f174863355bf4 (patch) | |
| tree | 30e195811ae1cc89f21fc92bd61f0b66a0729fa8 /docs/system/proxy.rst | |
| parent | d0ca509e506f5357c86007a250f2b26f8252a3c4 (diff) | |
| download | vyos-documentation-add0a00124c364f17ad3bb86ef8f174863355bf4.tar.gz vyos-documentation-add0a00124c364f17ad3bb86ef8f174863355bf4.zip | |
system-proxy: cli options documented
Diffstat (limited to 'docs/system/proxy.rst')
| -rw-r--r-- | docs/system/proxy.rst | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/docs/system/proxy.rst b/docs/system/proxy.rst new file mode 100644 index 00000000..4ff5717b --- /dev/null +++ b/docs/system/proxy.rst @@ -0,0 +1,28 @@ +.. _proxy: + +System Proxy +============ + +Some IT environments require the use of a proxy to connect to the Internet. +The option allowes to set a HTTP proxy and if necessary, supports `basic auth`_. + +The code example below sets a proxy for all HTTP, HTTPS and FTP (anonymous ftp) connections, initiated by vyos. + +.. code-block:: sh + + set system proxy url http://10.100.100.1 + set system proxy port 8080 + +That enables the update of a system image if the vyos system operates behind a proxy. + +.. code-block:: sh + + vyos@vyos:~$ add system image https://downloads.vyos.io/rolling/current/amd64/vyos-rolling-latest.iso + Trying to fetch ISO file from https://downloads.vyos.io/rolling/current/amd64/vyos-rolling-latest.iso + % Total % Received % Xferd Average Speed Time Time Time Current + Dload Upload Total Spent Left Speed + 1 413M 1 4479k 0 0 995k 0 0:07:04 0:00:04 0:07:00 995k + + + +.. _`basic auth`: https://tools.ietf.org/html/rfc7617 |