Looking for some advanced TYPO3 Flow configuration options? Take a look at Settings.yaml!

Though configuring TYPO3 Flow is very straightforward and pretty well documented, the Definitive Guide tells you more about how to configure your installation/package than telling you about what exactly you can configure. Here is where the Settings.yaml of the TYPO3.Flow package steps in.

Having read the Configuration part of the documentation you know for example about the different possible file locations of the configuration files and their priorities, know about how to access the settings in your code or even know how to inject settings to your models’ properties.

While those topics refer mainly to your own package’s settings, information about the basic TYPO3 Flow settings is scattered over the whole documentation (see e.g. here on Authentication or here on creating your own error views/404 pages). Unfortunately an overview of all possible configuration options is missing in the (online) documentation.

But this doesn’t matter much. Just open the Settings.yaml in /Packages/Framework/TYPO3.Flow/Configuration/ and you will find almost everything you need and even with verbose comments on each option. Just use this as a reference for your configuration needs! To be honest, this took me some time to realize – after having spent hours on googling for certain options…

Naturally you must not change the settings directly here. Set them in the global Settings.yaml in your installation’s /Configuration/ folder instead (or respectively in the /Configuration/<ApplicationContext>/ folders).

And don’t be baffled by the seemingly overwhelming amount of configuration options. You probably will never need most of them . But hidden among them are some, you most likely will need one day or another and which are not necessarily mentioned in the documentation:

Setting the path to your PHP binary

Not only useful for installing Flow on Windows, but also when running Flow on a shared hosting platform:

Setting the baseUri of your application

Normally gets autodetected. But there may be cases, where you want to set it explicitly:

Setting the default language (defaultLocale)

Default language of Flow is English. Change this here to your preferred language, for example when working with XLIFF for localization and the default language is not English (German in the example):

Setting the session timeout

Set the time in seconds after which the session of an idle user expires:


This is only a small excerpt of what can be found. Just dig into the Settings.yaml by yourself and see what matters to you!


1 Star2 Stars3 Stars4 Stars5 Stars (2 votes, average: 3.00 out of 5)

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code class="" title="" data-url=""> <del datetime=""> <em> <i> <q cite=""> <strike> <strong> <pre class="" title="" data-url=""> <span class="" title="" data-url="">