New: The State of API Reliability Report 2025 has landed.

  1. Support
  2. Knowledge base
  3. Synthetic Monitoring
  4. Checkpoints
  5. Private locations
  6. Install a Docker checkpoint

Install a Docker checkpoint

This article explains how to set up and start a Docker-based private checkpoint.

Before installation, ensure that all the requirements and settings are met. Uptrends will provide you with all the necessary files to get started.

Installation steps

You can install a private location using Windows or Linux operating systems.

Install private locations for Windows

To install a private location using the script:

  1. Go to Private locations.
  2. If you haven’t added any Private locations, click Add location. Once added, two checkpoints will be included by default.
  3. Click the Private location’s checkpoint name.
  4. Select the required operating system from the Host Operating System dropdown.
  5. Click Download installation zip file.
Important: Keep in mind that the downloaded .zip file only contains the specific private locations checkpoint you selected from the two default options. Your .zip file has a file name UptrendsCheckpoints<checkpoint-name>.zip, where <checkpoint-name> is the name of your checkpoint.
  1. Unzip the downloaded file in the folder where you want to install the private checkpoint.
  2. To prevent screenshots from uploading to the cloud, edit the docker-compose file after downloading and extracting the files.
Important: Depending on your company’s policies, you might need to unblock all the Powershell script files (*.ps1) in the zip folder before running them. For more information, see the instructions on how to unblock files.
  1. Open PowerShell as Administrator.
  2. Run ./install-checkpoint.ps1 in the Uptrends unzip directory. This will restart the server once. The script will configure a task that runs once every hour to check the Uptrends containers for updates.

The checkpoints are now available and can be selected in the monitor’s Checkpoints tab. You can also view the checkpoints in the Check details dialog when running a quick test directly from the monitor using Test now.

To install certificates in Private locations, see Install certificates in Private locations.

Install private locations for Linux

To install a private location using the script:

  1. Go to Private locations.
  2. If you haven’t added any Private locations, click Add location. Once added, two checkpoints will be included by default.
  3. Click the Private location’s checkpoint name.
  4. Select the required operating system from the Host Operating System dropdown.
  5. Click Download installation zip file.
Important: Keep in mind that the downloaded .zip file only contains the specific private locations checkpoint you selected from the two default options. Your .zip file has a file name UptrendsCheckpoints<checkpoint-name>.zip, where <checkpoint-name> is the name of your checkpoint.
  1. Install Docker engine and Docker compose for your distribution.
  2. Unzip the downloaded file and place its contents in the /opt/uptrendscheckpoint directory.
  3. Run install-checkpoint.sh to start the installation.

The checkpoints are now available and can be selected in the monitor’s Checkpoints tab. You can also view the checkpoints in the Check details dialog when running a quick test directly from the monitor using Test now.

To install certificates in Private locations, see Install certificates in Private locations.

Monitoring your private checkpoint

Uptrends will make changes to your account to better assist you in monitoring your private checkpoints. Please ensure that all your private checkpoint’s servers, firewall, internet connection, and other supporting systems remain accessible.

During the private checkpoint setup, Uptrends will add additional monitors and configurations. Please do not delete or modify anything in your account.

For more information, refer to the How to use Private locations knowledge base article.

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