Setup

Prerequisites

• Valid cloud platform credentials (currently Azure)
• Running Neo4j instance
• Appropriate permissions for target cloud environment

Warning

• Neo4j requires APOC plugin

Install Cirro

Shell Script (Unix/Linux/macOS)PowerShell (Windows)Manual Download

curl -sSL https://github.com/bishopfox/cirro/releases/latest/download/cirro-installer.sh | sh

irm https://github.com/bishopfox/cirro/releases/latest/download/cirro-installer.ps1 | iex

Download pre-built binaries from the releases page.

Collect Data (Azure)

# Using Azure CLI authentication
cirro collect az azcli

# Using client secret
cirro collect az client-secret \
  --client-id <CLIENT_ID> \
  --client-secret <CLIENT_SECRET> \
  --tenant-id <TENANT_ID>

Ingest into Graph Database

Neo4j is supported as the graph database backend. Set up your database before ingesting cloud data. There is a docker-compose file in the tools directory to assist with containerized database setup.

# For Neo4j
docker-compose up

# For Neo4j
cirro graph ingest --type az --file cirro_output.db \
    --server bolt://localhost:7687 \
  --user neo4j \
  --password password

Next Steps

After completing the quick start:

1. Explore Your Data: Use your graph database's query interface to explore the collected data
2. Learn Query Patterns: Check out our dashboard examples for common analysis patterns
3. Set Up Visualization: Configure dashboards and visualizations for your specific use case
4. Advanced Features: Explore data enrichment and custom collection options