System requirements for running TYPO3

PHP requirements and configuration

TYPO3 requires PHP with a supported version and specific configuration values and extensions.

memory_limit = 256M
max_execution_time = 240
max_input_vars = 1500
pcre.jit = 1

post_max_size = 10M
upload_max_filesize = 10M

Image processing requirements

If you want TYPO3 to automatically process images (e.g. cropping, resizing, thumbnail generation), install one of the following tools on your server:

• GraphicsMagick (≥ 1.3) (recommended)
• ImageMagick (≥ 6)

These tools are used by TYPO3 for features such as image rendering in content elements and backend previews.

Supported web servers and configuration

TYPO3 supports the following web servers, each requiring specific configuration:

• Apache (Linux/macOS/Windows)
• NGINX (Linux/macOS/Windows)
• IIS (Windows) (Microsoft Windows only)

AllowOverride Indexes FileInfo

# TYPO3 - GZIP support for versioned .js and .css files
location ~ \.js\.gzip$ {
    add_header Content-Encoding gzip;
    gzip off;
    types { text/javascript gzip; }
}
location ~ \.css\.gzip$ {
    add_header Content-Encoding gzip;
    gzip off;
    types { text/css gzip; }
}

# TYPO3 - Rewrite versioned static resources
if (!-e $request_filename) {
    rewrite ^/(.+)\.(\d+)\.(php|js|css|png|jpg|gif|gzip)$ /$1.$3 last;
}

# TYPO3 - Deny access to sensitive files and directories
location ~* composer\.(?:json|lock)$       { deny all; }
location ~* flexform[^.]*\.xml$            { deny all; }
location ~* locallang[^.]*\.(?:xml|xlf)$   { deny all; }
location ~* ext_conf_template\.txt$        { deny all; }
location ~* ext_typoscript_.*\.txt$        { deny all; }
location ~* \.(?:bak|co?nf|cfg|ya?ml|ts|typoscript|tsconfig|dist|fla|in[ci]|log|sh|sql|sqlite)$ {
    deny all;
}
location ~ _(?:recycler|temp)_/            { deny all; }
location ~ fileadmin/(?:templates)/.*\.(?:txt|ts|typoscript)$ { deny all; }
location ~ ^(?:vendor|typo3_src|typo3temp/var) { deny all; }
location ~ (?:typo3conf/ext|typo3/sysext|typo3/ext)/[^/]+/(?:Configuration|Resources/Private|Tests?|docs?)/ {
    deny all;
}

# TYPO3 - Frontend entry point
location / {
    try_files $uri $uri/ /index.php$is_args$args;
}

# TYPO3 - Backend entry point
location = /typo3 {
    rewrite ^ /typo3/;
}
location /typo3/ {
    absolute_redirect off;
    try_files $uri /index.php$is_args$args;
}

# TYPO3 - PHP handler via PHP-FPM
location ~ [^/]\.php(/|$) {
    fastcgi_split_path_info ^(.+?\.php)(/.*)$;
    if (!-f $document_root$fastcgi_script_name) {
        return 404;
    }
    fastcgi_buffer_size 32k;
    fastcgi_buffers 8 16k;
    fastcgi_connect_timeout 240s;
    fastcgi_read_timeout 240s;
    fastcgi_send_timeout 240s;

    fastcgi_pass         php-fpm:9000;
    fastcgi_index        index.php;
    include              fastcgi.conf;
}

Using TYPO3 with Docker-based environments

TYPO3 runs well in Docker-based environments. You can combine PHP with Apache or NGINX using official base images.

Recommended base images:

• Apache: php:8.4-apache
• NGINX: nginx:stable + php:8.4-fpm

Install required PHP extensions and set suitable PHP configuration.

FROM php:8.4-apache

# Enable Apache mod_rewrite
RUN a2enmod rewrite

# Install required PHP extensions for TYPO3
RUN apt-get update && apt-get install -y \
    libzip-dev libpng-dev libxml2-dev libonig-dev libicu-dev unzip git \
    && docker-php-ext-install \
    pdo pdo_mysql mysqli intl xml mbstring tokenizer opcache zip gd \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

# Set recommended PHP settings
COPY php.ini /usr/local/etc/php/

# Document root
WORKDIR /var/www/html

FROM php:8.4-fpm

# Install required PHP extensions for TYPO3
RUN apt-get update && apt-get install -y \
    libzip-dev libpng-dev libxml2-dev libonig-dev libicu-dev unzip git \
    && docker-php-ext-install \
    pdo pdo_mysql mysqli intl xml mbstring tokenizer opcache zip gd \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

# Set recommended PHP settings
COPY php.ini /usr/local/etc/php/

# Document root
WORKDIR /var/www/html

The Dockerfiles reference a php.ini file with recommended settings:

memory_limit = 256M
max_execution_time = 240
max_input_vars = 1500
post_max_size = 10M
upload_max_filesize = 10M
pcre.jit = 1

Using DDEV for local TYPO3 development

DDEV is a widely used and recommended solution for running TYPO3 projects locally. It provides a preconfigured Docker-based environment with TYPO3- compatible PHP, web server, and database services.

To set up a TYPO3 project with PHP 8.4, run:

ddev config --php-version 8.4 --docroot public --project-type typo3

This will generate the necessary configuration and allow you to start the project using:

ddev start

DDEV supports Composer-based TYPO3 projects and works on Linux, macOS, and Windows. It is ideal for teams and reproducible local setups.

Supported database systems and required permissions

TYPO3 supports the following relational database systems:

• MySQL
• MariaDB
• PostgreSQL
• SQLite

Each system has specific configuration and extension requirements. See the list of required PHP extensions for supported databases:

• Database-specific PHP extensions

The database user must be granted specific privileges to allow TYPO3 to function correctly.

Composer usage in TYPO3 projects

Composer is required for Composer-based TYPO3 installations and is commonly used in modern development workflows.

It is not required for Classic mode installations using the source package.

In production environments, Composer is not needed if the project is deployed using file-based methods (for example Rsync, Deployer).