Skip to main content

Run with Docker

If you would like to run with Docker, you'll need install docker and docker-compose:

  • Install options for docker here.
  • Install options for docker-compose (if it doesn’t come bundled with Docker) here.

Run with docker-compose

  1. Make sure you have configured your packages/api/.env file with the environment variables you need for your cloud provider(s).

  2. Ensure you have cloud provider credentials files in the following locations on your filesystem:

    • AWS: $HOME/.aws/credentials
    • GCP: $HOME/.config/gcloud/service-account-keys.json
  3. Ensure you have saved your environment variables as files on your local file system. Docker compose will use these securely as Docker Secrets at run time, in the ~/.docker/secrets directory. To aid with this, we have a command you can run that does this:

    yarn create-docker-secrets
  4. Remove any secrets in docker-compose.yml that you are not using.

  5. Run the application with docker compose:

    docker-compose up
  6. You can then access the dashboard at http://localhost:80

Run the API as a Docker container

If you would like to only run the API as a docker container, for example to deploy this as a service for your organization, you can pull and run it with these commands:

docker pull cloudcarbonfootprint/api

docker run \
--env-file packages/api/.env \
--env GOOGLE_APPLICATION_CREDENTIALS=/root/.config/gcloud/service-account-keys.json \
-p 4000:4000 \
-v $HOME/.aws/credentials:/root/.aws/credentials \
-v $HOME/.config/gcloud/service-account-keys.json:/root/.config/gcloud/service-account-keys.json \

Then you can access the API at: http://localhost:4000/api/footprint?start=2021-01-01&end=2021-02-01

Run the Client as a Docker container

If you would like to run the client as a docker container, you can pull and run it with these commands after running API as a docker container:

docker pull cloudcarbonfootprint/client:latest

docker run \
-p 80:80 \
-v ${PWD}/docker/nginx.conf:/etc/nginx/nginx.conf \

Then you can access the client at: http://localhost:80

Made for the 🌎 by Thoughtworks

Cloud Carbon Footprint is an open-source project, sponsored by Thoughtworks Inc. under the Apache License, Version 2.0