#1 Global Leader in Data Protection & Ransomware Recovery

How to Configure WinHTTP Proxy for Veeam Components

KB ID: 3090
Product: Veeam Backup & Replication | 10 | 11 | 12 | 12.1
Published: 2020-01-20
Last Modified: 2023-12-14
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.

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 some Veeam Backup & Replication communications. Some connections used by Veeam Backup & Replication 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 disaplay 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 protcol 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 reCAPTCHA and the Google Privacy Policy and Terms of Service apply.
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 reCAPTCHA and the Google Privacy Policy and Terms of Service apply.
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.