| Name | prowler JSON |
| Version |
5.9.0
JSON |
| download |
| home_page | https://github.com/prowler-cloud/prowler |
| Summary | Prowler is an Open Source security tool to perform AWS, GCP and Azure security best practices assessments, audits, incident response, continuous monitoring, hardening and forensics readiness. It contains hundreds of controls covering CIS, NIST 800, NIST CSF, CISA, RBI, FedRAMP, PCI-DSS, GDPR, HIPAA, FFIEC, SOC2, GXP, AWS Well-Architected Framework Security Pillar, AWS Foundational Technical Review (FTR), ENS (Spanish National Security Scheme) and your custom security frameworks. |
| upload_time | 2025-07-17 16:51:31 |
| maintainer | Prowler Engineering |
| docs_url | None |
| author | Toni de la Fuente |
| requires_python | <3.13,>3.9.1 |
| license | Apache-2.0 |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<p align="center">
<img align="center" src="https://github.com/prowler-cloud/prowler/blob/master/docs/img/prowler-logo-black.png#gh-light-mode-only" width="50%" height="50%">
<img align="center" src="https://github.com/prowler-cloud/prowler/blob/master/docs/img/prowler-logo-white.png#gh-dark-mode-only" width="50%" height="50%">
</p>
<p align="center">
<b><i>Prowler</b> is the Open Cloud Security platform trusted by thousands to automate security and compliance in any cloud environment. With hundreds of ready-to-use checks and compliance frameworks, Prowler delivers real-time, customizable monitoring and seamless integrations, making cloud security simple, scalable, and cost-effective for organizations of any size.
</p>
<p align="center">
<b>Learn more at <a href="https://prowler.com">prowler.com</i></b>
</p>
<p align="center">
<a href="https://goto.prowler.com/slack"><img width="30" height="30" alt="Prowler community on Slack" src="https://github.com/prowler-cloud/prowler/assets/38561120/3c8b4ec5-6849-41a5-b5e1-52bbb94af73a"></a>
<br>
<a href="https://goto.prowler.com/slack">Join our Prowler community!</a>
</p>
<hr>
<p align="center">
<a href="https://goto.prowler.com/slack"><img alt="Slack Shield" src="https://img.shields.io/badge/slack-prowler-brightgreen.svg?logo=slack"></a>
<a href="https://pypi.org/project/prowler/"><img alt="Python Version" src="https://img.shields.io/pypi/v/prowler.svg"></a>
<a href="https://pypi.python.org/pypi/prowler/"><img alt="Python Version" src="https://img.shields.io/pypi/pyversions/prowler.svg"></a>
<a href="https://pypistats.org/packages/prowler"><img alt="PyPI Prowler Downloads" src="https://img.shields.io/pypi/dw/prowler.svg?label=prowler%20downloads"></a>
<a href="https://hub.docker.com/r/toniblyx/prowler"><img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/toniblyx/prowler"></a>
<a href="https://hub.docker.com/r/toniblyx/prowler"><img alt="Docker" src="https://img.shields.io/docker/cloud/build/toniblyx/prowler"></a>
<a href="https://hub.docker.com/r/toniblyx/prowler"><img alt="Docker" src="https://img.shields.io/docker/image-size/toniblyx/prowler"></a>
<a href="https://gallery.ecr.aws/prowler-cloud/prowler"><img width="120" height=19" alt="AWS ECR Gallery" src="https://user-images.githubusercontent.com/3985464/151531396-b6535a68-c907-44eb-95a1-a09508178616.png"></a>
<a href="https://codecov.io/gh/prowler-cloud/prowler"><img src="https://codecov.io/gh/prowler-cloud/prowler/graph/badge.svg?token=OflBGsdpDl"/></a>
</p>
<p align="center">
<a href="https://github.com/prowler-cloud/prowler"><img alt="Repo size" src="https://img.shields.io/github/repo-size/prowler-cloud/prowler"></a>
<a href="https://github.com/prowler-cloud/prowler/issues"><img alt="Issues" src="https://img.shields.io/github/issues/prowler-cloud/prowler"></a>
<a href="https://github.com/prowler-cloud/prowler/releases"><img alt="Version" src="https://img.shields.io/github/v/release/prowler-cloud/prowler"></a>
<a href="https://github.com/prowler-cloud/prowler/releases"><img alt="Version" src="https://img.shields.io/github/release-date/prowler-cloud/prowler"></a>
<a href="https://github.com/prowler-cloud/prowler"><img alt="Contributors" src="https://img.shields.io/github/contributors-anon/prowler-cloud/prowler"></a>
<a href="https://github.com/prowler-cloud/prowler"><img alt="License" src="https://img.shields.io/github/license/prowler-cloud/prowler"></a>
<a href="https://twitter.com/ToniBlyx"><img alt="Twitter" src="https://img.shields.io/twitter/follow/toniblyx?style=social"></a>
<a href="https://twitter.com/prowlercloud"><img alt="Twitter" src="https://img.shields.io/twitter/follow/prowlercloud?style=social"></a>
</p>
<hr>
<p align="center">
<img align="center" src="/docs/img/prowler-cli-quick.gif" width="100%" height="100%">
</p>
# Description
**Prowler** is an open-source security tool designed to assess and enforce security best practices across AWS, Azure, Google Cloud, and Kubernetes. It supports tasks such as security audits, incident response, continuous monitoring, system hardening, forensic readiness, and remediation processes.
Prowler includes hundreds of built-in controls to ensure compliance with standards and frameworks, including:
- **Industry Standards:** CIS, NIST 800, NIST CSF, and CISA
- **Regulatory Compliance and Governance:** RBI, FedRAMP, and PCI-DSS
- **Frameworks for Sensitive Data and Privacy:** GDPR, HIPAA, and FFIEC
- **Frameworks for Organizational Governance and Quality Control:** SOC2 and GXP
- **AWS-Specific Frameworks:** AWS Foundational Technical Review (FTR) and AWS Well-Architected Framework (Security Pillar)
- **National Security Standards:** ENS (Spanish National Security Scheme)
- **Custom Security Frameworks:** Tailored to your needs
## Prowler CLI and Prowler Cloud
Prowler offers a Command Line Interface (CLI), known as Prowler Open Source, and an additional service built on top of it, called <a href="https://prowler.com">Prowler Cloud</a>.
## Prowler App
Prowler App is a web-based application that simplifies running Prowler across your cloud provider accounts. It provides a user-friendly interface to visualize the results and streamline your security assessments.
>For more details, refer to the [Prowler App Documentation](https://docs.prowler.com/projects/prowler-open-source/en/latest/#prowler-app-installation)
## Prowler CLI
```console
prowler <provider>
```
## Prowler Dashboard
```console
prowler dashboard
```
# Prowler at a Glance
| Provider | Checks | Services | [Compliance Frameworks](https://docs.prowler.com/projects/prowler-open-source/en/latest/tutorials/compliance/) | [Categories](https://docs.prowler.com/projects/prowler-open-source/en/latest/tutorials/misc/#categories) |
|---|---|---|---|---|
| AWS | 567 | 82 | 36 | 10 |
| GCP | 79 | 13 | 10 | 3 |
| Azure | 142 | 18 | 10 | 3 |
| Kubernetes | 83 | 7 | 5 | 7 |
| GitHub | 16 | 2 | 1 | 0 |
| M365 | 69 | 7 | 3 | 2 |
| NHN (Unofficial) | 6 | 2 | 1 | 0 |
> [!Note]
> The numbers in the table are updated periodically.
> [!Tip]
> For the most accurate and up-to-date information about checks, services, frameworks, and categories, visit [**Prowler Hub**](https://hub.prowler.com).
> [!Note]
> Use the following commands to list Prowler's available checks, services, compliance frameworks, and categories: `prowler <provider> --list-checks`, `prowler <provider> --list-services`, `prowler <provider> --list-compliance` and `prowler <provider> --list-categories`.
# 💻 Installation
## Prowler App
Prowler App offers flexible installation methods tailored to various environments:
> For detailed instructions on using Prowler App, refer to the [Prowler App Usage Guide](https://docs.prowler.com/projects/prowler-open-source/en/latest/tutorials/prowler-app/).
### Docker Compose
**Requirements**
* `Docker Compose` installed: https://docs.docker.com/compose/install/.
**Commands**
``` console
curl -LO https://raw.githubusercontent.com/prowler-cloud/prowler/refs/heads/master/docker-compose.yml
curl -LO https://raw.githubusercontent.com/prowler-cloud/prowler/refs/heads/master/.env
docker compose up -d
```
> Containers are built for `linux/amd64`.
### Configuring Your Workstation for Prowler App
If your workstation's architecture is incompatible, you can resolve this by:
- **Setting the environment variable**: `DOCKER_DEFAULT_PLATFORM=linux/amd64`
- **Using the following flag in your Docker command**: `--platform linux/amd64`
> Once configured, access the Prowler App at http://localhost:3000. Sign up using your email and password to get started.
### Common Issues with Docker Pull Installation
> [!Note]
If you want to use AWS role assumption (e.g., with the "Connect assuming IAM Role" option), you may need to mount your local `.aws` directory into the container as a volume (e.g., `- "${HOME}/.aws:/home/prowler/.aws:ro"`). There are several ways to configure credentials for Docker containers. See the [Troubleshooting](./docs/troubleshooting.md) section for more details and examples.
You can find more information in the [Troubleshooting](./docs/troubleshooting.md) section.
### From GitHub
**Requirements**
* `git` installed.
* `poetry` v2 installed: [poetry installation](https://python-poetry.org/docs/#installation).
* `npm` installed: [npm installation](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm).
* `Docker Compose` installed: https://docs.docker.com/compose/install/.
**Commands to run the API**
``` console
git clone https://github.com/prowler-cloud/prowler
cd prowler/api
poetry install
eval $(poetry env activate)
set -a
source .env
docker compose up postgres valkey -d
cd src/backend
python manage.py migrate --database admin
gunicorn -c config/guniconf.py config.wsgi:application
```
> [!IMPORTANT]
> As of Poetry v2.0.0, the `poetry shell` command has been deprecated. Use `poetry env activate` instead for environment activation.
>
> If your Poetry version is below v2.0.0, continue using `poetry shell` to activate your environment.
> For further guidance, refer to the Poetry Environment Activation Guide https://python-poetry.org/docs/managing-environments/#activating-the-environment.
> After completing the setup, access the API documentation at http://localhost:8080/api/v1/docs.
**Commands to run the API Worker**
``` console
git clone https://github.com/prowler-cloud/prowler
cd prowler/api
poetry install
eval $(poetry env activate)
set -a
source .env
cd src/backend
python -m celery -A config.celery worker -l info -E
```
**Commands to run the API Scheduler**
``` console
git clone https://github.com/prowler-cloud/prowler
cd prowler/api
poetry install
eval $(poetry env activate)
set -a
source .env
cd src/backend
python -m celery -A config.celery beat -l info --scheduler django_celery_beat.schedulers:DatabaseScheduler
```
**Commands to run the UI**
``` console
git clone https://github.com/prowler-cloud/prowler
cd prowler/ui
npm install
npm run build
npm start
```
> Once configured, access the Prowler App at http://localhost:3000. Sign up using your email and password to get started.
## Prowler CLI
### Pip package
Prowler CLI is available as a project in [PyPI](https://pypi.org/project/prowler-cloud/). Consequently, it can be installed using pip with Python >3.9.1, <3.13:
```console
pip install prowler
prowler -v
```
>For further guidance, refer to [https://docs.prowler.com](https://docs.prowler.com/projects/prowler-open-source/en/latest/#prowler-cli-installation)
### Containers
**Available Versions of Prowler CLI**
The following versions of Prowler CLI are available, depending on your requirements:
- `latest`: Synchronizes with the `master` branch. Note that this version is not stable.
- `v4-latest`: Synchronizes with the `v4` branch. Note that this version is not stable.
- `v3-latest`: Synchronizes with the `v3` branch. Note that this version is not stable.
- `<x.y.z>` (release): Stable releases corresponding to specific versions. You can find the complete list of releases [here](https://github.com/prowler-cloud/prowler/releases).
- `stable`: Always points to the latest release.
- `v4-stable`: Always points to the latest release for v4.
- `v3-stable`: Always points to the latest release for v3.
The container images are available here:
- Prowler CLI:
- [DockerHub](https://hub.docker.com/r/toniblyx/prowler/tags)
- [AWS Public ECR](https://gallery.ecr.aws/prowler-cloud/prowler)
- Prowler App:
- [DockerHub - Prowler UI](https://hub.docker.com/r/prowlercloud/prowler-ui/tags)
- [DockerHub - Prowler API](https://hub.docker.com/r/prowlercloud/prowler-api/tags)
### From GitHub
Python >3.9.1, <3.13 is required with pip and Poetry:
``` console
git clone https://github.com/prowler-cloud/prowler
cd prowler
eval $(poetry env activate)
poetry install
python prowler-cli.py -v
```
> [!IMPORTANT]
> To clone Prowler on Windows, configure Git to support long file paths by running the following command: `git config core.longpaths true`.
> [!IMPORTANT]
> As of Poetry v2.0.0, the `poetry shell` command has been deprecated. Use `poetry env activate` instead for environment activation.
>
> If your Poetry version is below v2.0.0, continue using `poetry shell` to activate your environment.
> For further guidance, refer to the Poetry Environment Activation Guide https://python-poetry.org/docs/managing-environments/#activating-the-environment.
# ✏️ High level architecture
## Prowler App
**Prowler App** is composed of three key components:
- **Prowler UI**: A web-based interface, built with Next.js, providing a user-friendly experience for executing Prowler scans and visualizing results.
- **Prowler API**: A backend service, developed with Django REST Framework, responsible for running Prowler scans and storing the generated results.
- **Prowler SDK**: A Python SDK designed to extend the functionality of the Prowler CLI for advanced capabilities.
## Prowler CLI
**Running Prowler**
Prowler can be executed across various environments, offering flexibility to meet your needs. It can be run from:
- Your own workstation
- A Kubernetes Job
- Google Compute Engine
- Azure Virtual Machines (VMs)
- Amazon EC2 instances
- AWS Fargate or other container platforms
- CloudShell
And many more environments.
# Deprecations from v3
## General
- `Allowlist` now is called `Mutelist`.
- The `--quiet` option has been deprecated. Use the `--status` flag to filter findings based on their status: PASS, FAIL, or MANUAL.
- All findings with an `INFO` status have been reclassified as `MANUAL`.
- The CSV output format is standardized across all providers.
**Deprecated Output Formats**
The following formats are now deprecated:
- Native JSON has been replaced with JSON in [OCSF] v1.1.0 format, which is standardized across all providers (https://schema.ocsf.io/).
## AWS
**AWS Flag Deprecation**
The flag --sts-endpoint-region has been deprecated due to the adoption of AWS STS regional tokens.
**Sending FAIL Results to AWS Security Hub**
- To send only FAILS to AWS Security Hub, use one of the following options: `--send-sh-only-fails` or `--security-hub --status FAIL`.
# 📖 Documentation
**Documentation Resources**
For installation instructions, usage details, tutorials, and the Developer Guide, visit https://docs.prowler.com/
# 📃 License
**Prowler License Information**
Prowler is licensed under the Apache License 2.0, as indicated in each file within the repository. Obtaining a Copy of the License
A copy of the License is available at <http://www.apache.org/licenses/LICENSE-2.0>
Raw data
{
"_id": null,
"home_page": "https://github.com/prowler-cloud/prowler",
"name": "prowler",
"maintainer": "Prowler Engineering",
"docs_url": null,
"requires_python": "<3.13,>3.9.1",
"maintainer_email": "engineering@prowler.com",
"keywords": null,
"author": "Toni de la Fuente",
"author_email": "toni@blyx.com",
"download_url": "https://files.pythonhosted.org/packages/3a/82/a54fde6e6fd5957feee463ea138cca2bb2da029647df8aab6c34393dccc1/prowler-5.9.0.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <img align=\"center\" src=\"https://github.com/prowler-cloud/prowler/blob/master/docs/img/prowler-logo-black.png#gh-light-mode-only\" width=\"50%\" height=\"50%\">\n <img align=\"center\" src=\"https://github.com/prowler-cloud/prowler/blob/master/docs/img/prowler-logo-white.png#gh-dark-mode-only\" width=\"50%\" height=\"50%\">\n</p>\n<p align=\"center\">\n <b><i>Prowler</b> is the Open Cloud Security platform trusted by thousands to automate security and compliance in any cloud environment. With hundreds of ready-to-use checks and compliance frameworks, Prowler delivers real-time, customizable monitoring and seamless integrations, making cloud security simple, scalable, and cost-effective for organizations of any size.\n</p>\n<p align=\"center\">\n<b>Learn more at <a href=\"https://prowler.com\">prowler.com</i></b>\n</p>\n\n<p align=\"center\">\n<a href=\"https://goto.prowler.com/slack\"><img width=\"30\" height=\"30\" alt=\"Prowler community on Slack\" src=\"https://github.com/prowler-cloud/prowler/assets/38561120/3c8b4ec5-6849-41a5-b5e1-52bbb94af73a\"></a>\n <br>\n <a href=\"https://goto.prowler.com/slack\">Join our Prowler community!</a>\n</p>\n<hr>\n<p align=\"center\">\n <a href=\"https://goto.prowler.com/slack\"><img alt=\"Slack Shield\" src=\"https://img.shields.io/badge/slack-prowler-brightgreen.svg?logo=slack\"></a>\n <a href=\"https://pypi.org/project/prowler/\"><img alt=\"Python Version\" src=\"https://img.shields.io/pypi/v/prowler.svg\"></a>\n <a href=\"https://pypi.python.org/pypi/prowler/\"><img alt=\"Python Version\" src=\"https://img.shields.io/pypi/pyversions/prowler.svg\"></a>\n <a href=\"https://pypistats.org/packages/prowler\"><img alt=\"PyPI Prowler Downloads\" src=\"https://img.shields.io/pypi/dw/prowler.svg?label=prowler%20downloads\"></a>\n <a href=\"https://hub.docker.com/r/toniblyx/prowler\"><img alt=\"Docker Pulls\" src=\"https://img.shields.io/docker/pulls/toniblyx/prowler\"></a>\n <a href=\"https://hub.docker.com/r/toniblyx/prowler\"><img alt=\"Docker\" src=\"https://img.shields.io/docker/cloud/build/toniblyx/prowler\"></a>\n <a href=\"https://hub.docker.com/r/toniblyx/prowler\"><img alt=\"Docker\" src=\"https://img.shields.io/docker/image-size/toniblyx/prowler\"></a>\n <a href=\"https://gallery.ecr.aws/prowler-cloud/prowler\"><img width=\"120\" height=19\" alt=\"AWS ECR Gallery\" src=\"https://user-images.githubusercontent.com/3985464/151531396-b6535a68-c907-44eb-95a1-a09508178616.png\"></a>\n <a href=\"https://codecov.io/gh/prowler-cloud/prowler\"><img src=\"https://codecov.io/gh/prowler-cloud/prowler/graph/badge.svg?token=OflBGsdpDl\"/></a>\n</p>\n<p align=\"center\">\n <a href=\"https://github.com/prowler-cloud/prowler\"><img alt=\"Repo size\" src=\"https://img.shields.io/github/repo-size/prowler-cloud/prowler\"></a>\n <a href=\"https://github.com/prowler-cloud/prowler/issues\"><img alt=\"Issues\" src=\"https://img.shields.io/github/issues/prowler-cloud/prowler\"></a>\n <a href=\"https://github.com/prowler-cloud/prowler/releases\"><img alt=\"Version\" src=\"https://img.shields.io/github/v/release/prowler-cloud/prowler\"></a>\n <a href=\"https://github.com/prowler-cloud/prowler/releases\"><img alt=\"Version\" src=\"https://img.shields.io/github/release-date/prowler-cloud/prowler\"></a>\n <a href=\"https://github.com/prowler-cloud/prowler\"><img alt=\"Contributors\" src=\"https://img.shields.io/github/contributors-anon/prowler-cloud/prowler\"></a>\n <a href=\"https://github.com/prowler-cloud/prowler\"><img alt=\"License\" src=\"https://img.shields.io/github/license/prowler-cloud/prowler\"></a>\n <a href=\"https://twitter.com/ToniBlyx\"><img alt=\"Twitter\" src=\"https://img.shields.io/twitter/follow/toniblyx?style=social\"></a>\n <a href=\"https://twitter.com/prowlercloud\"><img alt=\"Twitter\" src=\"https://img.shields.io/twitter/follow/prowlercloud?style=social\"></a>\n</p>\n<hr>\n<p align=\"center\">\n <img align=\"center\" src=\"/docs/img/prowler-cli-quick.gif\" width=\"100%\" height=\"100%\">\n</p>\n\n# Description\n\n**Prowler** is an open-source security tool designed to assess and enforce security best practices across AWS, Azure, Google Cloud, and Kubernetes. It supports tasks such as security audits, incident response, continuous monitoring, system hardening, forensic readiness, and remediation processes.\n\nProwler includes hundreds of built-in controls to ensure compliance with standards and frameworks, including:\n\n- **Industry Standards:** CIS, NIST 800, NIST CSF, and CISA\n- **Regulatory Compliance and Governance:** RBI, FedRAMP, and PCI-DSS\n- **Frameworks for Sensitive Data and Privacy:** GDPR, HIPAA, and FFIEC\n- **Frameworks for Organizational Governance and Quality Control:** SOC2 and GXP\n- **AWS-Specific Frameworks:** AWS Foundational Technical Review (FTR) and AWS Well-Architected Framework (Security Pillar)\n- **National Security Standards:** ENS (Spanish National Security Scheme)\n- **Custom Security Frameworks:** Tailored to your needs\n\n## Prowler CLI and Prowler Cloud\n\nProwler offers a Command Line Interface (CLI), known as Prowler Open Source, and an additional service built on top of it, called <a href=\"https://prowler.com\">Prowler Cloud</a>.\n\n## Prowler App\n\nProwler App is a web-based application that simplifies running Prowler across your cloud provider accounts. It provides a user-friendly interface to visualize the results and streamline your security assessments.\n\n\n\n>For more details, refer to the [Prowler App Documentation](https://docs.prowler.com/projects/prowler-open-source/en/latest/#prowler-app-installation)\n\n## Prowler CLI\n\n```console\nprowler <provider>\n```\n\n\n\n## Prowler Dashboard\n\n```console\nprowler dashboard\n```\n\n\n# Prowler at a Glance\n\n| Provider | Checks | Services | [Compliance Frameworks](https://docs.prowler.com/projects/prowler-open-source/en/latest/tutorials/compliance/) | [Categories](https://docs.prowler.com/projects/prowler-open-source/en/latest/tutorials/misc/#categories) |\n|---|---|---|---|---|\n| AWS | 567 | 82 | 36 | 10 |\n| GCP | 79 | 13 | 10 | 3 |\n| Azure | 142 | 18 | 10 | 3 |\n| Kubernetes | 83 | 7 | 5 | 7 |\n| GitHub | 16 | 2 | 1 | 0 |\n| M365 | 69 | 7 | 3 | 2 |\n| NHN (Unofficial) | 6 | 2 | 1 | 0 |\n\n> [!Note]\n> The numbers in the table are updated periodically.\n\n> [!Tip]\n> For the most accurate and up-to-date information about checks, services, frameworks, and categories, visit [**Prowler Hub**](https://hub.prowler.com).\n\n> [!Note]\n> Use the following commands to list Prowler's available checks, services, compliance frameworks, and categories: `prowler <provider> --list-checks`, `prowler <provider> --list-services`, `prowler <provider> --list-compliance` and `prowler <provider> --list-categories`.\n\n# \ud83d\udcbb Installation\n\n## Prowler App\n\nProwler App offers flexible installation methods tailored to various environments:\n\n> For detailed instructions on using Prowler App, refer to the [Prowler App Usage Guide](https://docs.prowler.com/projects/prowler-open-source/en/latest/tutorials/prowler-app/).\n\n### Docker Compose\n\n**Requirements**\n\n* `Docker Compose` installed: https://docs.docker.com/compose/install/.\n\n**Commands**\n\n``` console\ncurl -LO https://raw.githubusercontent.com/prowler-cloud/prowler/refs/heads/master/docker-compose.yml\ncurl -LO https://raw.githubusercontent.com/prowler-cloud/prowler/refs/heads/master/.env\ndocker compose up -d\n```\n\n> Containers are built for `linux/amd64`.\n\n### Configuring Your Workstation for Prowler App\n\nIf your workstation's architecture is incompatible, you can resolve this by:\n\n- **Setting the environment variable**: `DOCKER_DEFAULT_PLATFORM=linux/amd64`\n- **Using the following flag in your Docker command**: `--platform linux/amd64`\n\n> Once configured, access the Prowler App at http://localhost:3000. Sign up using your email and password to get started.\n\n### Common Issues with Docker Pull Installation\n\n> [!Note]\n If you want to use AWS role assumption (e.g., with the \"Connect assuming IAM Role\" option), you may need to mount your local `.aws` directory into the container as a volume (e.g., `- \"${HOME}/.aws:/home/prowler/.aws:ro\"`). There are several ways to configure credentials for Docker containers. See the [Troubleshooting](./docs/troubleshooting.md) section for more details and examples.\n\nYou can find more information in the [Troubleshooting](./docs/troubleshooting.md) section.\n\n\n### From GitHub\n\n**Requirements**\n\n* `git` installed.\n* `poetry` v2 installed: [poetry installation](https://python-poetry.org/docs/#installation).\n* `npm` installed: [npm installation](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm).\n* `Docker Compose` installed: https://docs.docker.com/compose/install/.\n\n**Commands to run the API**\n\n``` console\ngit clone https://github.com/prowler-cloud/prowler\ncd prowler/api\npoetry install\neval $(poetry env activate)\nset -a\nsource .env\ndocker compose up postgres valkey -d\ncd src/backend\npython manage.py migrate --database admin\ngunicorn -c config/guniconf.py config.wsgi:application\n```\n> [!IMPORTANT]\n> As of Poetry v2.0.0, the `poetry shell` command has been deprecated. Use `poetry env activate` instead for environment activation.\n>\n> If your Poetry version is below v2.0.0, continue using `poetry shell` to activate your environment.\n> For further guidance, refer to the Poetry Environment Activation Guide https://python-poetry.org/docs/managing-environments/#activating-the-environment.\n\n> After completing the setup, access the API documentation at http://localhost:8080/api/v1/docs.\n\n**Commands to run the API Worker**\n\n``` console\ngit clone https://github.com/prowler-cloud/prowler\ncd prowler/api\npoetry install\neval $(poetry env activate)\nset -a\nsource .env\ncd src/backend\npython -m celery -A config.celery worker -l info -E\n```\n\n**Commands to run the API Scheduler**\n\n``` console\ngit clone https://github.com/prowler-cloud/prowler\ncd prowler/api\npoetry install\neval $(poetry env activate)\nset -a\nsource .env\ncd src/backend\npython -m celery -A config.celery beat -l info --scheduler django_celery_beat.schedulers:DatabaseScheduler\n```\n\n**Commands to run the UI**\n\n``` console\ngit clone https://github.com/prowler-cloud/prowler\ncd prowler/ui\nnpm install\nnpm run build\nnpm start\n```\n\n> Once configured, access the Prowler App at http://localhost:3000. Sign up using your email and password to get started.\n\n## Prowler CLI\n### Pip package\nProwler CLI is available as a project in [PyPI](https://pypi.org/project/prowler-cloud/). Consequently, it can be installed using pip with Python >3.9.1, <3.13:\n\n```console\npip install prowler\nprowler -v\n```\n>For further guidance, refer to [https://docs.prowler.com](https://docs.prowler.com/projects/prowler-open-source/en/latest/#prowler-cli-installation)\n\n### Containers\n\n**Available Versions of Prowler CLI**\n\nThe following versions of Prowler CLI are available, depending on your requirements:\n\n- `latest`: Synchronizes with the `master` branch. Note that this version is not stable.\n- `v4-latest`: Synchronizes with the `v4` branch. Note that this version is not stable.\n- `v3-latest`: Synchronizes with the `v3` branch. Note that this version is not stable.\n- `<x.y.z>` (release): Stable releases corresponding to specific versions. You can find the complete list of releases [here](https://github.com/prowler-cloud/prowler/releases).\n- `stable`: Always points to the latest release.\n- `v4-stable`: Always points to the latest release for v4.\n- `v3-stable`: Always points to the latest release for v3.\n\nThe container images are available here:\n- Prowler CLI:\n - [DockerHub](https://hub.docker.com/r/toniblyx/prowler/tags)\n - [AWS Public ECR](https://gallery.ecr.aws/prowler-cloud/prowler)\n- Prowler App:\n - [DockerHub - Prowler UI](https://hub.docker.com/r/prowlercloud/prowler-ui/tags)\n - [DockerHub - Prowler API](https://hub.docker.com/r/prowlercloud/prowler-api/tags)\n\n### From GitHub\n\nPython >3.9.1, <3.13 is required with pip and Poetry:\n\n``` console\ngit clone https://github.com/prowler-cloud/prowler\ncd prowler\neval $(poetry env activate)\npoetry install\npython prowler-cli.py -v\n```\n> [!IMPORTANT]\n> To clone Prowler on Windows, configure Git to support long file paths by running the following command: `git config core.longpaths true`.\n\n> [!IMPORTANT]\n> As of Poetry v2.0.0, the `poetry shell` command has been deprecated. Use `poetry env activate` instead for environment activation.\n>\n> If your Poetry version is below v2.0.0, continue using `poetry shell` to activate your environment.\n> For further guidance, refer to the Poetry Environment Activation Guide https://python-poetry.org/docs/managing-environments/#activating-the-environment.\n\n# \u270f\ufe0f High level architecture\n\n## Prowler App\n**Prowler App** is composed of three key components:\n\n- **Prowler UI**: A web-based interface, built with Next.js, providing a user-friendly experience for executing Prowler scans and visualizing results.\n- **Prowler API**: A backend service, developed with Django REST Framework, responsible for running Prowler scans and storing the generated results.\n- **Prowler SDK**: A Python SDK designed to extend the functionality of the Prowler CLI for advanced capabilities.\n\n\n\n## Prowler CLI\n\n**Running Prowler**\n\nProwler can be executed across various environments, offering flexibility to meet your needs. It can be run from:\n\n- Your own workstation\n\n- A Kubernetes Job\n\n- Google Compute Engine\n\n- Azure Virtual Machines (VMs)\n\n- Amazon EC2 instances\n\n- AWS Fargate or other container platforms\n\n- CloudShell\n\nAnd many more environments.\n\n\n\n# Deprecations from v3\n\n## General\n- `Allowlist` now is called `Mutelist`.\n- The `--quiet` option has been deprecated. Use the `--status` flag to filter findings based on their status: PASS, FAIL, or MANUAL.\n- All findings with an `INFO` status have been reclassified as `MANUAL`.\n- The CSV output format is standardized across all providers.\n\n**Deprecated Output Formats**\n\nThe following formats are now deprecated:\n- Native JSON has been replaced with JSON in [OCSF] v1.1.0 format, which is standardized across all providers (https://schema.ocsf.io/).\n\n## AWS\n\n**AWS Flag Deprecation**\n\nThe flag --sts-endpoint-region has been deprecated due to the adoption of AWS STS regional tokens.\n\n**Sending FAIL Results to AWS Security Hub**\n\n- To send only FAILS to AWS Security Hub, use one of the following options: `--send-sh-only-fails` or `--security-hub --status FAIL`.\n\n\n# \ud83d\udcd6 Documentation\n\n**Documentation Resources**\n\nFor installation instructions, usage details, tutorials, and the Developer Guide, visit https://docs.prowler.com/\n\n# \ud83d\udcc3 License\n\n**Prowler License Information**\n\nProwler is licensed under the Apache License 2.0, as indicated in each file within the repository. Obtaining a Copy of the License\n\nA copy of the License is available at <http://www.apache.org/licenses/LICENSE-2.0>\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Prowler is an Open Source security tool to perform AWS, GCP and Azure security best practices assessments, audits, incident response, continuous monitoring, hardening and forensics readiness. It contains hundreds of controls covering CIS, NIST 800, NIST CSF, CISA, RBI, FedRAMP, PCI-DSS, GDPR, HIPAA, FFIEC, SOC2, GXP, AWS Well-Architected Framework Security Pillar, AWS Foundational Technical Review (FTR), ENS (Spanish National Security Scheme) and your custom security frameworks.",
"version": "5.9.0",
"project_urls": {
"Changelog": "https://github.com/prowler-cloud/prowler/releases",
"Documentation": "https://docs.prowler.cloud",
"Homepage": "https://github.com/prowler-cloud/prowler",
"Issue tracker": "https://github.com/prowler-cloud/prowler/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "81f752e7a2688cc8dfc6ffaffec65397627b4107660477c47ade2d85bf980a37",
"md5": "5081bc20f7f38297d28ae48b2a7e1441",
"sha256": "9fba8b6bc0b42a5a19d45280d32f49a76a8bf4b48b6122ed753d7d25a001585d"
},
"downloads": -1,
"filename": "prowler-5.9.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5081bc20f7f38297d28ae48b2a7e1441",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>3.9.1",
"size": 5209950,
"upload_time": "2025-07-17T16:51:29",
"upload_time_iso_8601": "2025-07-17T16:51:29.163326Z",
"url": "https://files.pythonhosted.org/packages/81/f7/52e7a2688cc8dfc6ffaffec65397627b4107660477c47ade2d85bf980a37/prowler-5.9.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3a82a54fde6e6fd5957feee463ea138cca2bb2da029647df8aab6c34393dccc1",
"md5": "b424fc35f8df009c0c00cf52a1448a8e",
"sha256": "d1249422887a5097b95881149705549014f181381e3217c7ae70e0278a042e1a"
},
"downloads": -1,
"filename": "prowler-5.9.0.tar.gz",
"has_sig": false,
"md5_digest": "b424fc35f8df009c0c00cf52a1448a8e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>3.9.1",
"size": 3191482,
"upload_time": "2025-07-17T16:51:31",
"upload_time_iso_8601": "2025-07-17T16:51:31.249918Z",
"url": "https://files.pythonhosted.org/packages/3a/82/a54fde6e6fd5957feee463ea138cca2bb2da029647df8aab6c34393dccc1/prowler-5.9.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-17 16:51:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "prowler-cloud",
"github_project": "prowler",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "prowler"
}
