Veeam Support Knowledge Base
How to Configure WinHTTP Proxy for Veeam Components

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

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

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

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

Product

Topic

Description

By submitting, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.

Verify your email to continue your product download

We've sent a verification code to:

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!

Your feedback has been received and will be reviewed.

Oops! Something went wrong.

Please, try again later.