Installing extensions in composer based TYPO3 installations is not possible via the TYPO3 backend.
Trying so will yield the following error message:
The system is set to composer mode. Please notice that it is not possible to add an extension with the Extension Manager. You have to use composer to add further extensions to your system.
This tutorial assumes you're developing locally with docker/composer.
In our example we're adding the extension "powermail".
Find out the extension's composer path
You can usually get the composer path from the extension repository. Just search for the extension and look for "composer support".
For powermail, head to
The composer path is "composer req in2code/powermail".
Find out which version of the extension supports your TYPO3 version
Make sure that the version of the extension you're about to install is compatible for your TYPO3. If you want to install powermail in TYPO3 9.5 you can't install the newest version but need to install Version 7.4.
Add the extension to composer requirements
Now add the extension to composer requirements:
docker-compose run composer --ignore-platform-reqs require in2code/powermail ^7.4
ignores platform requirements - so if you don't have gd installed in the composer image installation does not fail
this is the path where the composer version of the extension is maintained
specifies the version we want to install (7.4.x)
Update you composer installation
docker-compose run composer update
After this step the extension is installed and you can activate it.
If your docker/composer setup is configured for automatic deployment you don't need to do anything. Pushing to the respective branches builds the TYPO3 as per the composer requirements and pushes the build to staging / production environment.