summaryrefslogtreecommitdiff
path: root/docs/system/proxy.rst
blob: 4ff5717b97acd15bee569595290d2259c3ba7faf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
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