#1 Global Leader in Data Protection & Ransomware Recovery

How to Configure WinHTTP Proxy for Veeam Components

KB ID: 3090
Product: Veeam Backup & Replication
Veeam ONE
Veeam Agent for Microsoft Windows
Veeam Cloud Connect
Published: 2020-01-20
Last Modified: 2024-03-13
mailbox
Get weekly article updates
By subscribing, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.

Cheers for trusting us with the spot in your mailbox!

Now you’re less likely to miss what’s been brewing in our knowledge base with this weekly digest

error icon

Oops! Something went wrong.

Please try again later.

Known Limitation
A tenant's Veeam Backup & Replication server cannot access Veeam Cloud Connect infrastructure components through HTTP/HTTPS proxy servers. All cloud-targeted traffic from the tenant's Veeam Backup & Replication server will ignore proxy settings.

Purpose

This article documents how to configure WinHTTP Proxy settings for Veeam components in environments where the software must use an HTTP proxy to access the internet.
WinHTTP vs WinInet Proxy Settings
This article documents the configuration of WinHTTP, which is used by various Veeam software products for communications. Some connections used by Veeam products utilize WinInet, which must be configured as documented in KB1975.

Solution

Known Limitation: WinHTTP does not support proxy authentication.
System-Wide Configuration
This change is system-wide and will affect all applications that use WinHTTP, including other third-party or Windows services that use WinHTTP (e.g., Windows Update).
Check Current WinHTTP Proxy Settings

This command will display the current WinHTTP settings:

netsh winhttp show proxy
Set WinHTTP Proxy Settings

This command can be used to set a WinHTTP proxy:

netsh winhttp set proxy proxy-server="<proxy>:<port>"

Note: Replace <proxy> and <port> in quotes with the actual proxy server's hostname or IP and the port it uses. For example this command would set the proxy for all protocols to use proxy.domain.tld (192.168.111.111) port 8080: 

netsh winhttp set proxy proxy-server="192.168.111.111:8080"
netsh winhttp set proxy proxy-server="proxy.domain.tld:8080"


A more advanced example using a specific protocol and exclusions:

netsh winhttp set proxy proxy-server="http=proxy.domain.tld:8080" bypass-list="*.labdomain.tld;*.devlab.tld"
Reset WinHTTP Proxy

This command can be used to reset the WinHTTP settings back to default (no proxy).

netsh winhttp reset proxy
To submit feedback regarding this article, please click this link: Send Article Feedback
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.

Spelling error in text

This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply except as noted in our Privacy Policy.
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

Oops! Something went wrong.

Please try again later.

You have selected too large block!

Please try select less.

KB Feedback/Suggestion

This form is only for KB Feedback/Suggestions, if you need help with the software open a support case

By submitting, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.
This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply except as noted in our Privacy Policy.
Verify your email to continue your product download
We've sent a verification code to:
  • Incorrect verification code. Please try again.
An email with a verification code was just sent to
Didn't receive the code? Click to resend in sec
Didn't receive the code? Click to resend
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

error icon

Oops! Something went wrong.

Please try again later.