TYPO3 Docker Images

Docker Images for most TYPO3 LTS versions

Project state

The Docker images in this project are not yet production ready and might be modified without backwards compatibility at any time.

Getting Started

These instructions cover usage information for the Docker image.

Prerequisities

In order to run this container you'll need docker installed.

• Windows
• OS X
• Linux

Usage

Quickstart

If you use Docker Compose there is an example docker-compose.yml file in each version specific directory of the repository.

Create a Docker network

docker network create typo3-db

Start a MySQL container

docker run -d --volume typo3-mysql:/var/lib/mysql/ --network typo3-db \
    --env MYSQL_DATABASE=typo3 --env MYSQL_USER=typo3 --env MYSQL_PASSWORD=ShouldBeAStrongPassword --env MYSQL_ROOT_PASSWORD=ShouldBeAStrongPassword \
    --name typo3-mysql mysql:5.7 --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci

Start the TYPO3 container that is based on the official PHP Docker Image.

docker run -d -p 80:80 --volume typo3:/var/www/html/ --network typo3-db \
    --env TYPO3_DB_HOST=typo3-mysql --env TYPO3_DB_NAME=typo3 --env TYPO3_DB_USERNAME=typo3 --env TYPO3_DB_PASSWORD=ShouldBeAStrongPassword \
    --env TYPO3_ADMIN_PASSWORD=ShouldBeAStrongPassword \
    --name typo3 crinis/typo3:9.5-php7.2-apache

Connect to your Docker host on port 80 and login on /typo3 using the default username "admin" and your password.

Environment Variables

• TYPO3_ADMIN_USERNAME - Initial admin username when installing TYPO3. (defaults to "admin")
• TYPO3_ADMIN_PASSWORD - Initial admin and Install Tool password when installing TYPO3.
• TYPO3_DB_HOST - Database host.
• TYPO3_DB_PORT - Database port. (defaults to "3306")
• TYPO3_DB_NAME - Database name.
• TYPO3_DB_USERNAME - Database username.
• TYPO3_DB_PASSWORD - Database password.
• TYPO3_SITE_NAME - Sets the sites title. (defaults to "TYPO3 CMS")
• TYPO3_CONTEXT - Could be "Production" or "Development" and is used by TYPO3 to determine if it runs in production or development mode. (defaults to "Production")
• MODIFY_LOCAL_CONFIGURATION - Set to "false" to disable modifications to your LocalConfiguration.php. (defaults to "true")
• SETUP_TYPO3_SRC - Setup symlinks for TYPO3 source that is shipped with the image. (defaults to "true")
• SETUP_TYPO3 - Attempts to setup TYPO3 ands adds a basic .htaccess file and cache configuration. (defaults to "true")

Secrets

Secrets can be mounted into the container as files and referenced by environment variables. If set they override the approriate environment variables above.

docker run -e TYPO3_ADMIN_PASSWORD_FILE=/run/secrets/typo3-admin-password ... -d crinis/typo3:tag

• TYPO3_ADMIN_USERNAME_FILE
• TYPO3_ADMIN_PASSWORD_FILE
• TYPO3_DB_HOST_FILE
• TYPO3_DB_PORT_FILE
• TYPO3_DB_NAME_FILE
• TYPO3_DB_USERNAME_FILE
• TYPO3_DB_PASSWORD_FILE

Volumes

• /var/www/html/ - Contains the TYPO3 installation

Useful File Locations

• /docker/AdditionalConfiguration.php - This file gets copied to /var/www/html/typo3conf/ if no file with that name exist already during TYPO3 setup.
• /docker/htaccess - Gets copied to /var/www/html/ if no file with that name exists already during TYPO3 setup. Only in TYPO3 7.6 and 6.2.
• /etc/supervisor/supervisord.conf - Supervisor configuration file to manage apache and cron processes.

Docker Image Tags

All available tags are listed here. Be as specific as possible when choosing the image tag for your deployment. Less specific tags can lead to unexpected TYPO3 or PHP versions. Picking 11.5.28-php8.1-apache makes sure you stay on this exact minor version of TYPO3 and PHP 8.1. If you chose 11.5.28 you might receive an unexpected PHP-Update at some point which breaks your installation.

Running on Kubernetes

An experimental Helm Chart is available here. There is no documentation yet so read the values.yaml file for variables.

Limitations

TYPO3 6.2 setup

Images for TYPO3 6.2 do not support automatic setup and configuration of TYPO3. You have to go through installation steps manually and make modifications in LocalConfiguration.php.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

• Crinis

License

This project is licensed under the MIT License - see the LICENSE.md file for details. The image contains software that use different licenses.

Acknowledgments

• This image installs and uses TYPO3 Console for simple setup and configuration.