blob: 6d432421aaf24c6c773e35e2879c1477b4ed1dc4 [file] [log] [blame]
------
Guide to using proxies
------
Jason van Zyl
------
12 October 2005
------
Configuring a proxy
You can configure a proxy to use for some or all of your HTTP requests in Maven 2.0. The username and password are only
required if your proxy requires basic authentication (note that later releases may support storing your passwords in
a secured keystore - in the mean time, please ensure your settings.xml file (usually $\{user.home\}/.m2/settings.xml) is secured with permissions
appropriate for your operating system).
The <<<nonProxyHosts>>> setting accepts wild cards, and each host not to proxy is separated by the | character. This matches
the JDK configuration equivalent.
+----+
<settings>
.
.
<proxies>
<proxy>
<active>true</active>
<protocol>http</protocol>
<host>proxy.somewhere.com</host>
<port>8080</port>
<username>proxyuser</username>
<password>somepassword</password>
<nonProxyHosts>www.google.com|*.somewhere.com</nonProxyHosts>
</proxy>
</proxies>
.
.
</settings>
+----+
Please note that urrently NTLM proxies are not supported as they have not been tested. You may be able to use the
relevant system properties on JDK 1.4+ to make this work.
* Resources
[[1]] {{{../../maven-settings/settings.html}Settings descriptor documentation}}
[[2]] {{{./guide-configuring-maven.html}Configuring Maven}}