Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Claudia is a free and open source cost and usage analytics solution that provides insights into your AWS cloud spending.

Claudia Screenshot


Official Claudia releases are made available as freely available AMIs on the AWS Marketplace. Visit the Claudia marketplace page to launch a Claudia instance in your account.


Login with the username admin and the EC2 instance ID as the password. Follow setup instructions at



  • docker
  • python
  • packer (for building AMI)

Build Claudia Container Image

Builds the claudia container image (default: claudia:latest)


Build AMI

Build an AMI image based on the local claudia container image (default: claudia:latest).

./ -c ami --aws-profile <profile_name>


Running Locally

After building the the container, run:

docker-compose up

Visit https://localhost to access the app.

Running in debug mode

docker-compose -f docker-compose-debug.yml up

Debug mode will:

  • Enable InfluxDB's admin interface
  • Expose the following ports:
    • Postgres 5432
    • InfluxDB 8086
    • InfluxDB admin UI 8083
    • ingestd 8081
    • claudiad 80/443
  • Leave the claudia container running in the event that the process dies, for the purpose of bashing into the container to restart the process manually or inspect any files.

Running in development mode

docker-compose -f docker-compose-dev.yml up

Development mode starts only the database containers (postgres and influxdb) and exposes their ports. This mode allows you to run ingestd and claudiad manually (e.g. go run) and connect to localhost IP addresses.

To run ingestd manually, and connect it to the localhost postgres and influxdb:

USERDB_HOST=localhost:5432 POSTGRES_DB=userdb POSTGRES_PASSWORD=my-secret-pw go run ingestd/main.go run --reportDir /tmp/claudia --costdb http://localhost:8086

To run claudiad manually, connect it to the localhost postgres, influxdb, and ingestd, while also disabling SSL and running it on a different port (8080):

USERDB_HOST=localhost:5432 POSTGRES_DB=userdb POSTGRES_PASSWORD=my-secret-pw go run claudiad/main.go --costdbURL http://localhost:8086 --ingestdURL http://localhost:8081 --assets ./ui/dist/ --insecure --port 8080


The documentation site is built using MkDocs, a static site generator that creates static documentation from markdown files.


pip install mkdocs mkdocs-bootswatch

Editing and previewing changes

Edit mkdocs.yml to change layout, headers, theme and other global settings. Edit markdown files under the docs directory to update and add new content.

Run the mkdocs server and visit http://localhost:8000 to preview your changes.

mkdocs serve


Run mkdocs gh-deploy to generate the static HTML and automatically push the contents into the gh-pages branch to reflect on the Claudia project page.

mkdocs gh-deploy