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

  1. Launch resources on AWS using Terraform (see here for advanced instructions if you prefer to set up resources manually or using different tools):
    git clone ccie && cd ccie
    # Ensure that DNS is enabled for your VPC.
    # Specifically, enableDnsSupport must be true.
    # If this is not enabled, then you must otherwise ensure that DNS is configured correctly on your instances
    # IMPORTANT: See [additional instructions if you are using a private subnet](/docs/enterprise/aws-private-subnet/).
    vi terraform.tfvars # Edit variables as appropriate with your favorite editor
    # Launch AWS resources with the Terraform wrapper script
    # (This script requires OSX. Please install Terraform yourself on Linux/Windows.)
    bin/terraform apply
  2. Fill out the settings form in the web UI:
    1. Go to the URL output from Terraform, click "Get Started", then click on "Advanced", "Add exception...", or whatever mechanism your browser provides to trust the temporary SSL cert
    2. Use a self-signed certificate, upload your license, and secure the console with a password
    3. Enter the current machine's IP address or a hostname that you have configured
    4. Create a GitHub developer application at <github base url>/settings/applications/new, set the callback URL to <circleci enterprise base url>/auth/github, and input the key and secret back in the settings page
    5. Either upload a valid SSL cert with intermediate certificates and key, or disable SSL (you can always add it later)
    6. 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 this:
      Look For 'Open'
  3. 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.