Prowler SaaS and Prowler Open Source are as dynamic and adaptable as the environment they’re meant to protect. Trusted by the leaders in security.
Learn more at prowler.com
# Description **Prowler** is an Open Source security tool to perform AWS, Azure, Google Cloud and Kubernetes security best practices assessments, audits, incident response, continuous monitoring, hardening and forensics readiness, and also remediations! We have Prowler CLI (Command Line Interface) that we call Prowler Open Source and a service on top of it that we call Prowler SaaS. This repository contains the REST API and Task Runner components for Prowler, which facilitate a complete backend that interacts with the Prowler SDK and is used by the Prowler UI. # Production deployment ## Install all dependencies with Poetry ```console poetry install poetry shell ``` ## Run the Django server with Gunicorn ```console cd src/backend gunicorn -c backend/guniconf.py backend.wsgi:application ``` > By default, the Gunicorn server will try to use as many workers as your machine can handle. You can manually change that in the `src/backend/backend/guniconf.py` file. # 💻 Development guide ## Local deployment This method requires installing a Python virtual environment and keep dependencies updated. ### Clone the repository ```console # HTTPS git clone https://github.com/prowler-cloud/restful-api.git # SSH git clone git@github.com:prowler-cloud/restful-api.git ``` ### Install the Python dependencies > You must have Poetry installed ```console poetry install poetry shell ``` ### Run the Django development server ```console cd backend python manage.py runserver ``` You can access the server in `http://localhost:8000`. All changes in the code will be automatically reloaded in the server. ## Docker deployment This method requires `docker` and `docker compose`. ### Clone the repository ```console # HTTPS git clone https://github.com/prowler-cloud/restful-api.git # SSH git clone git@github.com:prowler-cloud/restful-api.git ``` ### Build the base image ```console docker compose --profile dev build ``` ### Run the development service ```console docker compose --profile dev up ``` You can access the server in `http://localhost:8080`. All changes in the code will be automatically reloaded in the server. > **NOTE:** notice how the port is different. When developing using docker, the port will be `8080` to prevent conflicts.