Skip to main content

Installation

Prowler App supports multiple installation methods based on your environment. Refer to the Prowler App Tutorial for detailed usage instructions.
Prowler configuration is based in .env files. Every version of Prowler can have differences on that file, so, please, use the file that corresponds with that version or repository branch or tag.
  • Docker Compose
  • GitHub
Requirements:Commands:
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

Update Prowler App

Upgrade Prowler App installation using one of two options:

Option 1: Update Environment File

Edit the .env file and change version values:
PROWLER_UI_VERSION="5.9.0"
PROWLER_API_VERSION="5.9.0"

Option 2: Use Docker Compose Pull

docker compose pull --policy always
The --policy always flag ensures that Docker pulls the latest images even if they already exist locally.
What Gets Preserved During UpgradeEverything is preserved, nothing will be deleted after the update.

Troubleshooting

If containers don’t start, check logs for errors:
# Check logs for errors
docker compose logs

# Verify image versions
docker images | grep prowler
If you encounter issues, you can rollback to the previous version by changing the .env file back to your previous version and running:
docker compose pull
docker compose up -d

Container versions

The available versions of Prowler CLI are the following:
  • latest: in sync with master branch (please note that it is not a stable version)
  • v4-latest: in sync with v4 branch (please note that it is not a stable version)
  • v3-latest: in sync with v3 branch (please note that it is not a stable version)
  • <x.y.z> (release): you can find the releases here, those are stable releases.
  • stable: this tag always point to the latest release.
  • v4-stable: this tag always point to the latest release for v4.
  • v3-stable: this tag always point to the latest release for v3.
The container images are available here:
I