Welcome to the world of CloudGraph, the open-source universal GraphQL API and Cloud Security Posture Management (CSPM) tool that simplifies your cloud management across AWS, Azure, GCP, and K8s. In this guide, you’ll discover how to set up and effectively use CloudGraph for compliance checks, type-safe asset inventories, and much more!
What You Get with CloudGraph
- Free and effortless compliance checks for multiple standards
- Type-safe asset inventories for all your cloud resources
- Automatically generated documentation and query validation
- Full resource data including relationships between resources
- Historical snapshots of your cloud data
- A single endpoint to query across all your cloud data
- Enhanced billing and CloudWatch data for AWS
Setting Up CloudGraph
Getting started with CloudGraph requires just a few simple steps. Here’s how to do it:
1. System Requirements
- Docker must be installed on your machine.
2. Installation via Homebrew (Recommended)
If you’re on a Mac, you can install CloudGraph with Homebrew using the following command:
brew install cloudgraphdev/tap/cg
3. Installation via NPM
For Node.js users, you can install CloudGraph globally with:
npm i -g @cloudgraph/cli
Quick Start
Once you have CloudGraph installed, getting started is a breeze!
3 Simple Commands to Get Running
- cg init — This will prompt you to set up initial configurations for your providers.
- cg launch — This command launches a Dgraph instance that CloudGraph uses to store your data.
- cg scan — This will scan your cloud infrastructure for all configured providers.
Upon successful execution, your query tool will open in the browser for you to run queries, mutations and visualize your cloud infrastructure!
Understanding the CloudGraph Queries
Imagine a library full of different kinds of books, where each book represents a cloud service. Just like it’s convenient to retrieve information with just a few keywords in a library catalog, CloudGraph allows you to query your cloud data with a simple GraphQL syntax. For example:
query {
queryawsEc2 {
id
arn
}
}
In this case, you are asking for the IDs and Amazon Resource Names (ARNs) of all EC2 instances. Just like asking a librarian for specific titles, but in the world of cloud services!
Troubleshooting Issues
If you encounter issues, here are some common errors and what you can do to resolve them:
- Permission Errors: Often caused when CloudGraph doesn’t have enough permissions to read certain resources. Make sure your configurations give it read-only access.
- Connection Issues: Check if your Docker service is running as CloudGraph requires it for storing data.
- Incompatible Versions: Ensure that your CloudGraph CLI and provider modules are up to date. Try running
npm install -g @cloudgraph/clito update.
For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.
Final Thoughts
At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.
With this guide, you’re ready to dive into the world of CloudGraph! Happy querying!

