AWS AMI Install

The following step-by-step instructions will guide you through the process of installing CircleCI Enterprise on AWS. If you have any questions as you go through these steps, please contact


  • AWS Access Key
  • AWS Secret Key
  • AWS Region
    • For example: “us-west-2”
  • AWS Subnet ID
  • AWS S3 Bucket Name
  • Services Instance Type
    • The type of aws resource for our CircleCI service
  • Builder Instance Type
    • The type of aws resource for our CircleCI builder
  • Circle CI License .rli file.

Step One: Setup Terraform

If you prefer to do this process manually or with different tools please see the Manual Aws Instructions

Download the following repo: git clone ccie && cd ccie

Open terraform.tfvars in your favorite text editor and input the prerequities stated above in the required fields.

For Linux/Windows

Please install Terraform yourself on Linux/Windows. Then run the command below.


You can just run the command below.

bin/terraform apply

Configure Circle Ci Enterprise

  • Go To the URL output from Terraform
    1. Click "Get Started"
    2. Trust the temporary SSL cert
    3. Use a self-signed certificate ( or if you already have one feel free to use it here )
    4. Upload your license
    5. Secure the console with a password
    6. Enter the current machine's IP address or a hostname that you have configured
    7. Create a Github Developer Application
      1. Set the homepage URL to
      2. Set the callback URL to <circleci enterprise base url>/auth/github
    8. Input the key and secret from GitHub back into the settings page
    9. Either upload a valid SSL cert with intermediate certificates and key, or disable SSL (you can always add it later)
    10. Save and start the app (all other default settings are fine for now). You will be redirected to the System Console Dashboard, where you should soon see an indication that the app has started like below.
  • Look For 'Open'

    Using Circle CI Enterprise

  • Try it out!
    1. Click the "Open" link in the dashboard to go to the CircleCI Enterprise app. You may see a "Starting" page for a few minutes to indicate that the CircleCI application is booting up, but you will soon be automatically redirected to the homepage for your CircleCI Enterprise installation.
    2. Sign up and follow a project
    3. The first build may remain queued while the build containers start. You can check the "Fleet State" by clicking on the wrench icon on the sidebar and selecting "Fleet State". If no instances appear in the list, then the first builder is still starting. If there is a builder instance in the list but its state is "starting-up", then it is still downloading the build container image and starting its first build containers. Once this is all done, the first build should begin immediately. If there are no updates after about 15 minutes (remember to click the "refresh" button occasionally), please contact CircleCI Enterprise support.