Docs
circleci.com
Start Building for Free

IP ranges

1 month ago4 min read
Cloud
On This Page

Enable CircleCI jobs to go through a set of well-defined IP address ranges.

Overview

IP ranges is a feature for CircleCI customers who need to configure IP-based access to their restricted environments. As part of this feature, CircleCI provides a list of well-defined IP address ranges associated with the CircleCI service. CircleCI jobs that have this feature enabled will have their traffic routed through one of the defined IP address ranges during job execution.

The feature is available to customers on a Performance or Scale plan. Pricing is calculated based on data usage of jobs that have opted in to using the IP ranges feature. Details on the pricing model can be found in this Discuss post.

IP ranges: use cases

IP ranges lets you limit inbound connections to your infrastructure to only IP address ranges that are verifiably associated with CircleCI.

Some example use cases where IP-based restricted access might be desired include:

  • Accessing private artifact repositories
  • Pulling dependencies from a CocoaPods proxy hosted behind a firewall
  • Running test cases on an internal environment
  • Performing integration testing against private AWS resources
  • Deploying an internal app with sensitive data
  • Granting access to a production network

Prior to offering IP ranges, the only solution CircleCI offered to configure and control static IP addresses was CircleCI’s Runner. IP ranges now enables you to meet your IP-based security and compliance requirements using your existing workflows and platform.

Example configuration file using IP ranges

version: 2.1
jobs:
  build:
    circleci_ip_ranges: true # opts the job into the IP ranges feature
    docker:
      - image: curlimages/curl
    steps:
      - run: echo “Hello World”
workflows:
  build-workflow:
    jobs:
      - build

List of IP address ranges associated with feature

Last updated: 2022-04-06

Jobs that have been opted into the IP ranges feature will have one of the following IP address ranges associated with them:

  • 3.228.39.90
  • 18.213.67.41
  • 34.194.94.201
  • 34.194.144.202
  • 34.197.6.234
  • 35.169.17.173
  • 35.174.253.146
  • 52.3.128.216
  • 52.4.195.249
  • 52.5.58.121
  • 52.21.153.129
  • 52.72.72.233
  • 54.92.235.88
  • 54.161.182.76
  • 54.164.161.41
  • 54.166.105.113
  • 54.167.72.230
  • 54.172.26.132
  • 54.205.138.102
  • 54.208.72.234
  • 54.209.115.53

List of IP address ranges for core services

These are the IP address ranges for core services (used to trigger jobs, exchange information about users between CircleCI and Github etc):

  • 18.214.70.5
  • 52.20.166.242
  • 18.214.156.84
  • 54.236.156.101
  • 52.22.215.219
  • 52.206.105.184
  • 52.6.77.249
  • 34.197.216.176
  • 35.174.249.131
  • 3.210.128.175

List of IP address ranges changelog

2021-08-23

  • Added new items to the list of IP address ranges for core services.

The machine-consumable lists have also been updated to reflect the new IP address ranges.

2022-04-06

  • Added and removed new IPs as part of enabling Docker pulls to go through the list of IPs.

The machine-consumable lists have also been updated to reflect the new IP address ranges.

Machine-consumable lists can be found by querying the DNS A records below:

  • IP address ranges for jobs: jobs.knownips.circleci.com.

  • IP address ranges for core services: core.knownips.circleci.com.

  • All IP address ranges: all.knownips.circleci.com.

To query these, you can use any DNS resolver. Here’s an example using dig with the default resolver:

dig all.knownips.circleci.com A +short

Notifications of a change to this list will be sent out by email to all customers who have at least one job opted into the IP ranges feature. When the feature is generally available, 30 days notice will be given before changes are made to the existing set of IP address ranges. This page and the machine-consumable list will also be updated when there are upcoming changes.

Pricing

Pricing is calculated based on data usage of jobs opted into the IP ranges feature. It is possible to mix jobs with and without the IP ranges feature within the same workflow or pipeline. Data used to pull in the Docker image to the container before the job starts executing does not incur usage costs for jobs with IP ranges enabled.

Specific rates and details can be found in this Discuss post.

IP ranges usage is visible in the “Plan Usage” page of the CircleCI app:

Screenshot showing the location of the IP ranges feature

On the Resources tab within the Job Details UI page, you can view approximations of network transfer for any Docker job, even those without the IP ranges feature enabled. This approximation can be used to predict the cost of enabling the IP ranges feature on a job without having to turn the feature on. See more details on Discuss. You can also view whether or not the job has IP ranges enabled by viewing the “IP Ranges” badge.

CircleCI about image

AWS and GCP IP Addresses

The machines that execute all jobs on CircleCI’s platform, not just jobs opted into IP ranges, are hosted on Amazon Web Services (AWS), Google Cloud Platform (GCP), and CircleCI’s macOS Cloud (see below). An exhaustive list of IP addresses that CircleCI’s traffic may come from on these cloud providers’ platforms can be found by looking up each cloud provider’s IP address ranges. AWS & GCP offer endpoints to find this information.

  • AWS: CircleCI uses the us-east-1 and us-east-2 regions
  • GCP: CircleCI uses the us-east1 and us-central1 regions

CircleCI does not recommend configuring an IP-based firewall based on the AWS or GCP IP addresses, as the vast majority are not CircleCI’s machines. Additionally, there is no guarantee that the addresses in the AWS or GCP endpoints persist from day-to-day, as these addresses are reassigned continuously.

CircleCI macOS Cloud

In addition to AWS and GCP (see above), CircleCI’s macOS Cloud hosts jobs executed by machines. The following IP address ranges are used by CircleCI macOS Cloud:

  • 162.252.208.0/24
  • 162.252.209.0/24
  • 192.206.63.0/24
  • 162.221.90.0/24
  • 38.39.177.0/24
  • 38.39.178.0/24
  • 38.39.188.0/24
  • 38.39.189.0/24
  • 38.39.186.0/24
  • 38.39.187.0/24
  • 38.39.184.0/24
  • 38.39.185.0/24
  • 38.39.183.0/24
  • 38.23.35.0/24
  • 38.23.36.0/24
  • 38.23.37.0/24
  • 198.206.135.0/24

IP ranges is the recommended method for configuring an IP-based firewall to allow traffic from CircleCI’s platform. Note: macOS builds are automatically restricted within the IP ranges listed here. In other words, you do not have to explicitly set circleci_ip_ranges: true for macOS builds.

Known limitations

  • There currently is no support for specifying IP ranges config syntax when using the pipeline parameters feature. Details in this Discuss post.
  • IP ranges is currently available exclusively for the Docker executor, not including remote_docker. Jobs that attempt to use the IP ranges feature with a Machine executor will fail with an error stating that the IP ranges feature only supports the Docker executor.

Help make this document better

This guide, as well as the rest of our docs, are open source and available on GitHub. We welcome your contributions.

Need support?

Our support engineers are available to help with service issues, billing, or account related questions, and can help troubleshoot build configurations. Contact our support engineers by opening a ticket.

You can also visit our support site to find support articles, community forums, and training resources.