ITRS named a Visionary in the 2025 Gartner® Magic Quadrant™ for Digital Experience Monitoring.

  1. Support
  2. Knowledge base
  3. Synthetic Monitoring
  4. Checkpoints
  5. Private locations
  6. Manage private locations

Manage private locations

Tip: If you are new to Private Locations, start with the Private locations overview to understand the main features.

Manage private locations

You can manage your private locations from Private locations in the Uptrends web application.

Add private locations

To add a private location:

  1. Click Add location.
  2. Enter the name for the new private location.
  3. Select the monitor group to track. This creates a health monitor for the private location status.
  4. Click Add private location.

Once created, two unconfigured and uninstalled checkpoints are added by default. You can install and host these checkpoints on servers to run monitoring checks within your network. You can also add more checkpoints later.

Manually update private locations

When you install a private checkpoint, it creates a script and a scheduled task (on Windows) or cron job (on Linux) that automatically updates checkpoint containers every hour. If you want to update them earlier or on a specific schedule, you can manually trigger the container update.

To update a container manually:

  1. Open PowerShell as Administrator (Windows) or terminal (Linux).
  2. Navigate to the directory with your docker-compose.yml (or compose.yaml) file and run:
  • docker-compose pull
  • docker-compose down
  • docker-compose up

During the update, your other private checkpoints will continue performing checks. You don’t need to disable the checkpoint being updated or stop any monitors. It’s recommended to have at least one other checkpoint instance running during the update.

Note: It is important to keep your Docker containers up to date. The containers have a built-in Chrome and Edge browser that must be kept current to avoid becoming a security liability. Uptrends will show a warning or error if your containers are out of date.

Rename a private location

  1. Click to edit the name.
  2. Enter the new name.
  3. Press Enter to save.

Remove a private location

  1. Click to delete a private location.
  2. Click Confirm.

All associated checkpoints will also be deleted.

Set private location permissions

Operators and operator groups may have different levels of access to private locations and their checkpoints. Controlling these permissions is essential for security and privacy.

To manage private location permissions:

  1. Go to Account setup > Operators and groups.
  2. Select the operators or groups to manage permissions for.
  3. Go to the Permissions tab.
  4. Select whether operators and groups can:
    • Create private locations — view and create private locations.
    • Use private locations — use private locations as checkpoints for monitors.
    • Edit private locations — access, edit, and delete private locations, and assign checkpoints to their monitors.

Administrators have full access to permissions by default. Operators with Use or Edit permissions can add private locations as checkpoints in the monitor Checkpoints tab. Those with Create or Edit permissions can access the Private locations menu.

Private Locations Permissions GIF

Monitor your own private location

Depending on your network setup, you might need to adjust your firewall to let private locations reach the monitored services.

Always ensure that at least one private checkpoint is available, so Uptrends can monitor your private location. Without available checkpoints, checks will not run, and no alerts will be triggered.

To receive timely alerts about issues with your private checkpoint network, Uptrends automatically creates the monitors listed below. Make sure to create an alert definition so the appropriate contacts are informed if a checkpoint goes down.

Monitor Type
Checkpoint <first checkpoint> health Multi-step API
Checkpoint <second checkpoint> health Multi-step API
Region <private location> health Multi-step API

Troubleshooting

For more troubleshooting tips, see Troubleshooting private locations.

By using the Uptrends website, you consent to the use of cookies in accordance with our Cookie Policy.