Contents
Prowler reads the configuration of your cloud account and lists risky settings, such as a public S3 bucket. On AWS, all you need to start is a user or role with read-only permissions.
This review is for people who manage AWS or other clouds and want to check their settings for gaps. After reading it, you can do the following:
- Set up the AWS permissions Prowler needs
- Check your own AWS account and read the report
- Narrow down the services and results
What Prowler does
Prowler calls cloud APIs to collect settings and compares them with its built-in checks. The checks map to standards such as CIS, NIST, PCI-DSS, and ISO 27001, so you can see which requirement of which standard you don’t meet.
The main officially supported targets are:
| Type | Targets |
|---|---|
| Cloud | AWS, Azure, Google Cloud, Oracle Cloud (OCI), Alibaba Cloud |
| Containers | Kubernetes |
| SaaS | Microsoft 365, Google Workspace, GitHub, Cloudflare, MongoDB Atlas, Okta, Vercel, and others |
| Code | IaC (Terraform and other configuration files, scanned with Trivy) |
The list grows often. Check the table in the official repository or Prowler Hub for the latest.
Besides the command-line Prowler CLI, there is Prowler Local Server with a web interface and the Prowler Cloud service. This review covers Prowler CLI.
--fixer.Required permissions (AWS)
The documentation tells you to attach these two AWS managed policies to the user or role that runs Prowler:
SecurityAuditViewOnlyAccess
Some checks need extra read permissions. Attach prowler-additions-policy.json from the official repository as a custom policy.
All of these are read permissions. A check needs no write access, so don’t run Prowler with administrator credentials.
Try it safely on your own AWS account
-
Install Python 3.10 or later, then run
pipx install prowlerorpip install prowler. On macOS and Linux,brew install prowleralso works. Ifprowler -vprints a version, you’re ready. -
In your own AWS account, create an IAM user or role with only the permissions above.
-
Set up those credentials as an AWS CLI profile.
-
Run Prowler with the profile and a region:
prowler aws --profile custom-profile -f us-east-1 -
When the run finishes, CSV, JSON-OCSF, and HTML reports appear in the
outputfolder. Open the HTML report to see the result of each check, such as PASS or FAIL.
Limiting the run to one region with -f keeps your first scan short.
Common tasks
| Task | Command |
|---|---|
| List available checks | prowler aws --list-checks |
| List available compliance frameworks | prowler aws --list-compliance |
| Check specific services only | prowler aws --services s3 ec2 |
| Exclude a check | prowler aws --excluded-checks s3_bucket_public_access |
| Show only failed results | prowler aws --status FAIL |
| Choose output formats and folder | prowler aws -M csv json-ocsf -o <output folder> |
| View reports in a browser | prowler dashboard |
Prowler exits with code 3 when any check fails. To keep CI from stopping, add -z (--ignore-exit-code-3).
Cautions
- Only check accounts you own or have written permission to check. Never run it with someone else’s credentials.
- With
--fixer, Prowler changes your cloud settings. The documentation notes that fixes for Access Analyzer, GuardDuty, and Security Hub may add AWS charges. Review them first withprowler aws --list-fixers. - The
prowler dashboardserver has no authentication. Don’t expose it to the internet. - Reports contain account IDs and resource names. Check the contents before you share them.
- We could not find Windows installation steps in the official documentation (unverified). An official Docker image (
toniblyx/prowler) is also available.
Read next
Sources
- Official repository READMEgithub.com/prowler-cloud/prowler
- Docs: Installing Prowler CLIdocs.prowler.com/getting-started/installation/prowler-cli
- Docs: Prowler CLI basic usagedocs.prowler.com/getting-started/basic-usage/prowler-cli
- Docs: AWS authentication and required permissionsdocs.prowler.com/user-guide/providers/aws/authentication
- Docs: Prowler Fixers (Remediations)docs.prowler.com/user-guide/cli/tutorials/fixer
- Docs: Miscellaneousdocs.prowler.com/user-guide/cli/tutorials/misc
- Docs: Prowler Local Dashboarddocs.prowler.com/user-guide/cli/tutorials/dashboard
Checked on 2026-10-24
Similar tools
Trivy
Impact Local onlyA scanner that finds vulnerabilities, misconfigurations, and embedded secrets in container images, code, and Kubernetes.
- Purpose
- Defense
- Type
- Command line
- Difficulty
- Beginner
- License
- PermissiveApache-2.0
- Category
- Vulnerability scanning / Containers and cloud