summaryrefslogtreecommitdiff
path: root/docs/configuration/system/proxy.md
blob: 3b12634bdf2a1ea85f5878e61be7a81fe43ec04c (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
(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 proxies require/support the "basic" HTTP authentication scheme as per
{rfc}`7617`, thus a username can be configured.
```
```{cfgcmd} set system proxy password \<password\>

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