Microsoft Azure Guest Proxy Agent

Microsoft Azure Guest Proxy Agent 1.0.52

This project introduces the Guest Proxy Agent (GPA) to enhance the security of the Azure Instance Metadata Service and Azure Wireserver endpoints (available in Azure IaaS VM/VMSS).

Download for Windows

About Microsoft Azure Guest Proxy Agent

This project introduces the Guest Proxy Agent (GPA) to enhance the security of the Azure Instance Metadata Service and Azure Wireserver endpoints (available in Azure IaaS VM/VMSS).

What's new in 1.0.52

Release notes
What's Changed
- Add Azure Linux 4 E2E test coverage by Zhidong Peng (@ZhidongPeng) in #385
- read and deserialize json UTF-8, UTF-16, UTF-32, BOM, LE/BE support by yinbing (@bingyuyin) in #386
- Add timeout for write_serial_console_log function. by Zhidong Peng (@ZhidongPeng) in #387
- GPA to support IPv6 dual-stack address by Zhidong Peng (@ZhidongPeng) in #388
- Update aya to v0.14 by Zhidong Peng (@ZhidongPeng) in #392
- Pin GitHub Actions to full-length commit SHAs by Dan Fiedler (@danfiedler-msft) in #390
- Bump the github-actions group with 9 updates by Dependabot (@dependabot)[bot] in #393
- Add parameter ipv6DualStackSupported for IMDSPingTest.ps1 by Zhidong Peng (@ZhidongPeng) in #394
- update eBPF-for-Windows to v1.5.0 by Zhidong Peng (@ZhidongPeng) in #391
- Use short-lived user cache for proxy authorization decision by Zhidong Peng (@ZhidongPeng) in #395
- Donot error out if authorize_connect6 not found in legacy eBPF program by Zhidong Peng (@ZhidongPeng) in #398
- TelemetryEventsRefactor: Move redact_secrets to the sequential background consumer by Zhidong Peng (@ZhidongPeng) in #399
- Bump the github-actions group with 2 updates by Dependabot (@dependabot)[bot] in #403
- secret_redactor refactor: set DFA size limit and serializing the searches in secret-redactor thread by Zhidong Peng (@ZhidongPeng) in #400
- WindowsEventWriter Refactor: Move windows event writer to async background thread by Zhidong Peng (@ZhidongPeng) in #401
- Report eBPFSvc, GuestProxyAgent service status, and surface eBPF/GPA … by Srikrishna Veturi (@srikrishnaveturi) in #396
- Make add connection summary as background operations. by Zhidong Peng (@ZhidongPeng) in #405
- skip redirector policy udpate in update_redirector_policy if proxy sever has not started yet. by Zhidong Peng (@ZhidongPeng) in #404
- Start proxy_server on a dedicated Tokio runtime by Zhidong Peng (@ZhidongPeng) in #402
- Update logging for linux memory usages by Zhidong Peng (@ZhidongPeng) in #406
- Prepare build for 1.0.49 release by Zhidong Peng (@ZhidongPeng) in #407
- Extra windows memory leaking fixes. by Zhidong Peng (@ZhidongPeng) in #409
- Bump streetsidesoftware/cspell-action from 9.0.1 to 9.1.0 in the github-actions group by Dependabot (@dependabot)[bot] in #408
- telemetry_event to use serialized_size instead of to_xml().length by Zhidong Peng (@ZhidongPeng) in #410
- Clearing regex cache due to memory usage exceeding limit by Zhidong Peng (@ZhidongPeng) in #411 …

Full release notes »

Technical details

PublisherMicrosoft Corporation
Version1.0.52
Release date2026-09-30
LicenseMIT
Installer typewix
Architecturex64, arm64
Package IDMicrosoft.Azure.GuestProxyAgent
Install scopeAll users

Install Microsoft Azure Guest Proxy Agent from the command line

Install with Windows Package Manager
winget install --id=Microsoft.Azure.GuestProxyAgent -e
Update to the latest version
winget upgrade --id=Microsoft.Azure.GuestProxyAgent -e
Uninstall
winget uninstall --id=Microsoft.Azure.GuestProxyAgent -e
Silent install with the offline installer
msiexec /i "Windows_183165466_GuestProxyAgent_AMD64_1.0.52.msi" /quiet /norestart
Uninstall the MSI package
msiexec /x {D7BEB30D-3B22-451F-A2D7-37342483A39C} /quiet

azure-gpaazure-iaasazure-instance-metadata-serviceazure-wireserverazuregpaazureiaasazureinstancemetadataserviceazurewireservermicrosoft-azure-guest-proxy-agentmicrosoftazureguestproxyagentproxy-agent-extensionproxyagentextension

Microsoft Azure Guest Proxy Agent version history

1.0.48 Sep 9, 2026

Release notes
──────────────────┬─────────────────┬─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Public Cloud Stage│Availability Date│Regions
──────────────────┼─────────────────┼─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Canary 1 │7/30/2026 │East US 2EUAP …

1.0.46 Jun 22, 2026

Release notes
──────────────────┬─────────────────┬─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Public Cloud Stage│Availability Date│Regions
──────────────────┼─────────────────┼─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Canary 1 │6/22/2026 │East US 2EUAP …

1.0.39 Jan 10, 2026

Frequently asked questions

Is Microsoft Azure Guest Proxy Agent free?

Yes. Microsoft Azure Guest Proxy Agent is free and open-source software released under the MIT license.

What is the latest version of Microsoft Azure Guest Proxy Agent?

The latest version is 1.0.52, released on Sep 30, 2026.

Is it safe to download Microsoft Azure Guest Proxy Agent?

The download button links to the official installer published on github.com, the same file Windows Package Manager installs. You can verify the downloaded file by comparing its SHA-256 checksum with b3932cc1e5033d76feac346ca16696a42f7e963661298183f1813a53d516741e.

Which Windows versions does Microsoft Azure Guest Proxy Agent support?

Microsoft Azure Guest Proxy Agent runs on Windows and is available for 64-bit (x64), ARM64 systems.

How do I install Microsoft Azure Guest Proxy Agent silently?

Run the offline installer with msiexec /i "Windows_183165466_GuestProxyAgent_AMD64_1.0.52.msi" /quiet /norestart, or install it with Windows Package Manager: winget install --id=Microsoft.Azure.GuestProxyAgent -e --silent.

How do I uninstall Microsoft Azure Guest Proxy Agent?

Open Settings › Apps › Installed apps, find Microsoft Azure Guest Proxy Agent and select Uninstall. From the command line, run winget uninstall --id=Microsoft.Azure.GuestProxyAgent -e.