Installation

Requirements

  • PHP: Version 8.0 to 8.3

  • PostgreSQL: Version 12 or greater

  • PHP extensions: PDO_PGSQL, cURL

  • HTTP web server: Apache with mod_rewrite and mod_headers enables

  • Operating system: A Unix-like system

  • Minimum hardware requirements:

    • PostgreSQL: 512 MB RAM (4 GB recommended)

    • Application: 128 MB RAM (1 GB recommended)

    • Storage: Approximately 3 GB of PostgreSQL storage per 1 million events

Instructions

  1. Download the latest version of tirreno (a ZIP file).

  2. Extract the tirreno-master.zip file to the location where you want it installed on your web server.

  3. Navigate to http://your-domain.example/install/index.php in a browser to launch the installation process.

  4. After the successful installation, delete the install/ directory and its contents.

  5. Navigate to http://your-domain.example/signup/ in a browser to create an administrator account.

  6. For cron jobs setup, insert the following schedule (every 10 minutes) expression with crontab -e command or by editing /var/spool/cron/your-web-server file:

*/10 * * * * cd /path/to/tirreno && /usr/bin/php /path/to/tirreno/index.php /cron >> /path/to/tirreno/logs/error.log 2>&1

Enrichment (optional)

The optional Enrichment API is available on subscription basis. This API provides extended information on IP addresses.

To start with the tirreno enrichment subscription:

  1. Navigate to the tirreno pricing page.

  2. Select the number of enrichment requests you need per month.

  3. Proceed with the subscription by entering your email and country in the Paddle checkout.

  4. Provide your credit card details and finalize the subscription payment.

After subscribing, you will receive an email from team@tirreno.com with the instructions and your enrichment key. If you do not receive the email, check your spam folder.

Follow these simple steps to activate your enrichment key:

  1. Log in to your tirreno platform and go to the API page.

  2. Copy the key from the email and paste it into the Enrichment key input field.

  3. Choose the type of data you would like to send for enrichment and click the Save button.

Voilà! Your tirreno subscription is now fully active.