Skip to main content

Get started

Infracost Cloud is our SaaS product that builds on top of Infracost open source. It enables team leads, managers and FinOps practitioners to see all cost estimates from a central place so they can help guide the team. Read our announcement blog to learn about its benefits.

Team visibility across all changes

1. Sign up or log in

Go to Infracost Cloud to sign up or log in to start your free trial (no credit card is needed).

2. Create new organization

Every Infracost user has a default organization for personal use. Create a new organization for your company using the organization dropdown at the top of the page.

Create new organization

3. Setup Infracost Cloud

  1. Switch to the desired organization
  2. Click on Org Settings
  3. Copy your Infracost API key, you will need it in Step 4
  4. Tick the box under Cost estimate dashboard. This instructs the Infracost CLI to send its JSON output to Infracost Cloud (the JSON does not contain any cloud credentials or secrets).
  5. Get organization API key

4. Update API key in CI/CD

If you are already running Infracost in your CI/CD system:

  1. Update the INFRACOST_API_KEY environment variable to your organization API key. Only API keys starting with ico- work with Infracost Cloud; if you have old API keys, discard them and use the one from your Org Settings page.
  2. Ensure that the Infracost CLI version being used is v0.10.11 or later.
  3. Remove the INFRACOST_ENABLE_CLOUD=false environment variable from your CI/CD.

Otherwise, setup one of our CI/CD integrations and set the INFRACOST_API_KEY environment variable to your organization API key.

5. Send a pull request

Send a new pull request to change something in Terraform that costs money, you should see a pull request comment in your CI/CD system.

If you do not use the infracost comment command in your CI/CD system, you can upload Infracost JSON files to Infracost Cloud.

6. See cost estimate in Infracost Cloud

Go to Infracost Cloud > your organization > Dashboard to see your pull request on the chart and cost breakdowns by repo, pull request and user. Clicking on a chart dot shows the corresponding estimate so you can investigate deeper or talk to the people working on the change.

If you run into any issues, check the troubleshooting guide or join our community Slack channel, we'll help you very quickly 😄

Infracost Cloud dashboard showing pull request cost changes over the last 30 days

7. Add your team members

Use the Members page to invite your team members to join your organization.