summaryrefslogtreecommitdiff
path: root/docs/configuration/system/proxy.rst
blob: 8e0339a732ea21f106eace4efc040177696636ff (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
.. _system_proxy:

############
System Proxy
############

Some IT environments require the use of a proxy to connect to the Internet.
Without this configuration VyOS updates could not be installed directly by
using the :opcmd:`add system image` command (:ref:`update_vyos`).

.. cfgcmd:: set system proxy url <url>

   Set proxy for all connections initiated by VyOS, including HTTP, HTTPS, and
   FTP (anonymous ftp).

.. cfgcmd:: set system proxy port <port>

   Configure proxy port if it does not listen to the default port 80.

.. cfgcmd:: set system proxy username <username>

   Some proxys require/support the "basic" HTTP authentication scheme as per
   :rfc:`7617`, thus a username can be configured.

.. cfgcmd:: set system proxy password <password>

   Some proxys require/support the "basic" HTTP authentication scheme as per
   :rfc:`7617`, thus a password can be configured.