Skip to main content

Installation

This guide will walk you through the process of installing Sentinel on your PrestaShop store.

Prerequisites​

Before installing Sentinel, ensure your system meets these requirements:

  • PrestaShop 1.7.7 - 9.0.x
  • PHP >= 7.2
  • Write permissions for /modules and /var/logs directories

Download the Module​

Browse all versions on the releases page.

Installation Methods​

  1. Download the module

    Download the latest version using the link above.

  2. Install the module

    Log in to your PrestaShop admin panel and navigate to:

    Modules > Module Manager

    Click the Install a module button

    Select the sentinel module zip file

Method 2: Manual Installation​

  1. Download the module

    Download the latest version using the link above.

  2. Extract the archive

    Extract the ZIP file to your PrestaShop /modules directory:

    cd /path/to/prestashop/modules
    unzip sentinel-1.0.0.zip

  3. Activate the module

    Log in to your PrestaShop admin panel and navigate to:

    Modules > Module Manager

    Search for "Sentinel" and click Install.

Post-installation​

Verify Installation​

After installation, verify that Sentinel is working correctly:

  1. Check that the module appears in Modules > Module Manager
  2. Ensure the module status is "Enabled"

Check Permissions​

Ensure the logs directory has write permissions:

chmod 755 /path/to/prestashop/var/logs

Test Protection​

You can test that Sentinel is protecting your store by attempting a benign SQL injection pattern in your browser:

https://yourstore.com/index.php?test=SELECT+SLEEP(1)

You should see a page blocked by Sentinel with a 403 error.

warning

Only test with benign patterns and on your own store. Never attempt real attacks.

Updating Sentinel​

Update Notifications​

Sentinel tells you when a newer version is published. Every call the module makes to the Sentinel API answers with the latest published version, so the check costs no extra request and needs no configuration.

When your installed version is behind, a banner appears at the top of every Sentinel page with:

  • the published version number and the one you are running
  • a link to the release page to download the update
  • a link to the changelog, when one is available

The PrestaShop home dashboard widget carries the same notice as a single line linking to the release.

Dismissing the banner hides it until the next version is published; the widget line stays, so a pending update is never entirely out of sight.

note

The banner relies on the module reaching the Sentinel API. A store whose outbound calls are blocked never sees it, so check the releases page from time to time.

Applying the Update​

  1. Download the new version from the releases page
  2. Go to Modules > Module Manager
  3. Click Upload a module and select the new ZIP file

Your settings, logs and whitelists are preserved.

Troubleshooting​

Permission Errors​

If you encounter permission errors during installation:

# Set correct ownership (replace www-data with your web server user)
sudo chown -R www-data:www-data /path/to/prestashop/modules/sentinel

# Set correct permissions
sudo chmod -R 755 /path/to/prestashop/modules/sentinel

Module Won't Activate​

If the module fails to activate:

  1. Check PHP error logs: /var/log/apache2/error.log or /var/log/php-fpm/error.log
  2. Verify PrestaShop version compatibility
  3. Check file permissions

Post-installation Configuration​

For complete protection, enable Auto Prepend File protection:

  1. Go to Modules > Sentinel > Configuration
  2. Click Try Automatic Installation
  3. If automatic installation fails, follow the manual instructions

2. Run a Vulnerability Scan​

Check if your installation contains known vulnerabilities:

  1. Go to Modules > Sentinel > Security Scanner
  2. Click Run Scan
  3. Review the report and fix detected vulnerabilities

3. Monitor Logs​

Logs are automatically created in /var/logs/sentinel-YYYY-MM-DD.log

See the Security Logs guide to learn how to analyze them.

Next Steps​

Now that Sentinel is installed, learn more about: