Sign inGet Started
ClickhouseNetwork Access

Network Access & IP Whitelisting

For UptimeDock to monitor your ClickHouse database, our monitoring servers need network access to your ClickHouse instance. If your database is not publicly accessible, you'll need to whitelist our IP addresses.

Overview

Many organizations restrict database access to specific IP addresses for security reasons. This is a best practice that we fully support. To enable monitoring while maintaining security, you can add UptimeDock's monitoring IP addresses to your whitelist.

When is this needed?

You only need to whitelist IP addresses if your ClickHouse instance is behind a firewall or has IP-based access restrictions. If your database is publicly accessible (not recommended for production), you can skip this step.

UptimeDock IP Addresses

Add the following IP address to your whitelist to allow UptimeDock to connect to your ClickHouse database:

RegionHostnameIP Address
US West (Oregon)clickhouse-us-west-2.uptimedock.com54.214.39.52
Keep Your Whitelist Updated

We recommend whitelisting by hostname when possible, as IP addresses may change during infrastructure updates. If you must use IP addresses, check this page periodically for updates or subscribe to our status page for notifications.

ClickHouse Cloud Setup

If you're using ClickHouse Cloud, you can easily add UptimeDock's IP address to your access list through the ClickHouse Cloud console.

Step 1: Access Settings

  1. Log in to your ClickHouse Cloud account
  2. From the left sidebar menu, click on Settings
  3. Navigate to the Security section

Step 2: Add IP to Access List

  1. Under the Security header, select the Security tab
  2. Find the IP access list section
  3. Click Add entry or the equivalent button to add a new IP
  4. Enter the UptimeDock IP address: 54.214.39.52
  5. Add a description like "UptimeDock Monitoring"
  6. Save your changes
Tip

Adding a clear description helps your team understand why this IP is whitelisted. We recommend using "UptimeDock Monitoring - US West" as the description.

Self-Hosted ClickHouse

For self-hosted ClickHouse instances, you'll need to work with your system administrators or network team to add UptimeDock's IP address to your firewall rules.

Common steps include:

  • Adding an inbound firewall rule to allow TCP traffic from 54.214.39.52
  • Allowing access to the ClickHouse native protocol port (typically 9000 or 9440 for TLS)
  • Updating security group rules if hosted on AWS, GCP, or Azure
  • Configuring iptables or firewalld rules for on-premise deployments

Example iptables rule:

# Allow UptimeDock monitoring access to ClickHouse
iptables -A INPUT -s 54.214.39.52 -p tcp --dport 9000 -j ACCEPT
iptables -A INPUT -s 54.214.39.52 -p tcp --dport 9440 -j ACCEPT

Example AWS Security Group rule:

TypeProtocolPort RangeSourceDescription
Custom TCPTCP900054.214.39.52/32UptimeDock Monitoring
Custom TCPTCP944054.214.39.52/32UptimeDock Monitoring (TLS)
Need Help?

If you're unsure how to configure your firewall or need assistance, please contact our support team. We're happy to help you set up network access securely.

Verify Connection

After adding the IP address to your whitelist, you can verify the connection by:

  1. Going to the Create New Check page
  2. Entering your ClickHouse connection details
  3. Clicking the Test Connection button

A successful test confirms that UptimeDock can reach your ClickHouse instance. If the test fails, double-check that:

  • The IP address is correctly added to your whitelist
  • The correct port is open (9000 for native protocol, 9440 for TLS)
  • Any intermediate firewalls or security groups also allow the traffic
You're All Set!

Once your connection test succeeds, you can proceed with the Quick Setup Guide to complete your ClickHouse monitoring configuration.