Compatibility and Requirements

Before you install Tideways make sure that your servers or development machines fullfill the requirements.

Supported PHP Versions

Tideways supports the following PHP versions: 5.3, 5.4, 5.5, 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 (last updated: October 2024)

Both NTS (non-thread safe) and ZTS (Zend Thread Safety) builds of PHP are supported.

Permissions

During installation "root" access to the server is often required.

There are exceptions for our many partnering hosters that provide a managed version of Tideways.

Operating Systems

Tideways is available for all Linux and macOS operating systems.

Since version 5.8.0 of the Tideways PHP extension when using glibc, version 2.17 is required. When using musl we require the latest stable minor release (1.2)

Windows or FreeBSD are not supported.

Processor Architectures

Tideways supports AMD64 (x64) and ARM64/AARCH64 processor architectures.

Web Servers

  • Apache 2 with mod_php

  • Webservers using PHP-FPM via FastCGI such as Nginx

  • PHP-CGI

  • FrankenPHP

Frameworks

The following frameworks are supported in Tideways (last updated: August 2025)

  • Symfony versions 2+

  • Laravel 4+

  • WordPress

  • Shopware 5 and 6

  • Oxid 5 and 6

  • Magento 1 and 2

  • Spryker

  • Yii 2

  • Drupal 7 and 8

  • TYPO3

  • Neos Flow

  • Slim

  • CakePHP 2, 3 and 4

  • Laminas

  • WoltLab Suite 5.5+

Firewall

Outside of the local network, Tideways only communicates using encrypted HTTPS connections on standard port 443, unless explicitly configured differently.

The following connections are made:

Tideways Extension

Tideways Extension does not listen on any sockets. Outgoing connections are only established to the Daemon, which is configured with the tideways.connection INI setting. The default is the /var/run/tideways/tidewaysd.sock Unix domain socket. Communication between Extension and Daemon uses a custom protocol. This connection is used to send performance data and to retrieve updated configuration.

Tideways Daemon

Tideways Daemon listens on the address specified with the -address flag. The default is a Unix domain socket in /var/run/tideways/tidewaysd.sock. Within Docker it listens to TCP port 9135 on all IPv4 and IPv6 interfaces by default. This socket is used for Extension to Daemon communication using a custom protocol.

It connects to Tideways Ingest on the address given within the -server flag. The default is https://ingest.tideways.com/. Communication between Daemon and Ingest uses regular HTTPs calls. This connection is used to send performance data and to retrieve updated configuration.

Tideways Daemon optionally supports sending metrics to StatsD. Metrics are only sent when either the -statsd or -dogstatds flag is specified. There is no default. Communication uses the UDP-based StatsD or DogStatsD protocol.

Tideways Proxy

Tideways Proxy listens on the address specified with the -listen flag. The default is a TCP socket in 127.0.0.1:8137. This socket is used for Daemon to Proxy communication and implements the Ingest HTTP API.

It connects to Tideways Ingest on the address given within the -server flag. The default is https://ingest.tideways.com/. Communication between Proxy and Ingest uses regular HTTPs calls. This connection is used to send performance data and to retrieve updated configuration.

Install Tideways

Installation with different distributions and platforms are described in individual chapters:

Still need help? Email [email protected]