summaryrefslogtreecommitdiff
path: root/docs/system/proxy.rst
blob: f57b5cd2fd051f08210d607e725083ce3f2852d8 (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
29
30
31
32
.. _proxy:

System Proxy
============

Some IT environments require the use of a proxy to connect to the Internet.
The ``system proxy`` option sets the configuration for a proxy, and if necessary, supports `basic auth`_.  

This example sets a proxy for all connections initiated by VyOS, including HTTP, HTTPS, and FTP (anonymous ftp).

.. code-block:: console

  set system proxy url http://10.100.100.1
  set system proxy port 8080

  # If a username and password are required
  set system proxy username vyosuser 
  set system proxy password vyosuser-password

That enables the update of a system image if the VyOS system operates behind a proxy.

.. code-block:: console

  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