Skip to content

[DOCS-15510] Add Windows private location upgrade steps #39743

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
git-thuerk-done wants to merge 2 commits into
base: master
Choose a base branch
from
+8 −0
Open

[DOCS-15510] Add Windows private location upgrade steps #39743

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
70f0e44
Add Windows private location upgrade steps
git-thuerk-done Sep 4, 2026
ecafc5c
Adjust Windows upgrade step wording
git-thuerk-done Sep 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions hugo/content/en/synthetics/platform/private_locations/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -917,6 +917,13 @@

**Note**: If you're using `docker run` to launch your Private Location image and you've previously installed the Private Location image using the `latest` tag, make sure to add `--pull=always` to the `docker run` command to make sure the newest version is pulled rather than relying on the cached version of the image that may exist locally with the same `latest` tag.

#### Upgrade a Windows private location

1. Back up your configuration file (`C:\ProgramData\Datadog Synthetics Private Location\config.json`) before upgrading or changing it.
2. Download the latest [MSI installer][34], run it, and follow the prompts. If prompted to modify or update your configuration, always use your backed-up file.
3. If you use the installer's **Modify** option, select your existing configuration file. Leaving the field blank or generating a new configuration replaces your current one.
4. Confirm that the private location worker service is running and references the correct configuration file.

### Test your internal endpoint

Once at least one private location worker starts reporting to Datadog, the private location status displays green.
Expand Down Expand Up @@ -1021,4 +1028,5 @@
[31]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_LinuxParameters.html
[32]: /synthetics/platform/private_locations/configuration
[33]: /synthetics/guide/kerberos-authentication/
[34]: https://ddsynthetics-windows.s3.amazonaws.com/datadog-synthetics-worker-{{< synthetics-worker-version "synthetics-windows-pl" >}}.amd64.msi

Check warning on line 1031 in hugo/content/en/synthetics/platform/private_locations/_index.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.words_case_sensitive 

Use 'Datadog' instead of 'datadog'.

Loading