---
title: Ein neues Zuhause für die Systemkonfiguration von TYPO3 in TYPO3 v12
url: "https://b13.com/de/wissen/ein-neues-zuhause-fuer-die-systemkonfiguration-von-typo3-in-typo3-v12"
description: "Du bist eingeladen: TYPO3 hat in TYPO3 v12 ein neues Zuhause für seine Systemkonfiguration. In unserem neuesten Beitrag stellen wir dir die neuen Änderungen vor, ihre Vorteile und wie sie in die Systemgeschichte von TYPO3 passen. "
image: "https://b13.com/fileadmin/_processed_/d/7/csm_SystemConfigurationV12_Sharing_921f592210.png"
date: 2024-02-14
modified: 2026-08-19
lastUpdated: 2026-08-19
---

# Ein neues Zuhause für die Systemkonfiguration von TYPO3 in TYPO3 v12

[ TYPO3 v12 ](https://b13.com/de/wissen/typo3-v12) [ TYPO3 ](https://b13.com/de/wissen/typo3)

 Ein neues Zuhause für die Systemkonfiguration von TYPO3 in TYPO3 v12
======================================================================

![](https://b13.com/fileadmin/_processed_/c/6/csm_benni_5e519221c4.jpg)Benni Mack

  14. März 2024

 [ RSS Feed ](https://b13.com/de/rss.xml)

  ![Zwei ineinandergreifende Zahnräder in Gelb, mit einem blauen Stromstecker und Kabel, die sie verbinden. Ein Etikett mit der Aufschrift "v12" hängt von einem der Zahnräder, vor einem hellblauen radialen Hintergrund.](https://b13.com/fileadmin/_processed_/d/c/csm_SystemConfigurationV12_Headerbild_6e42877a8b.webp)

TYPO3 Version 12 bringt eine Reihe von Änderungen mit sich, die sich sowohl auf die Konfiguration des Systems als auch auf die Benutzeroberfläche des Editors auswirken. Ein Hauptziel dieser Aktualisierungen ist es, die Lernkurve für Neueinsteiger zu vereinfachen.

In diesem Artikel befassen wir uns mit den Änderungen an den Systemkonfigurationsdateien. Unser Fokus liegt dabei auf zwei Aspekten: Zum einen möchten wir bestehende Site-Administratoren bei der Navigation durch diese Änderungen unterstützen und zum anderen eine klare Einführung für diejenigen bieten, die zum ersten Mal mit TYPO3 in Kontakt kommen.

   Erkundung der verschiedenen Einstellungen in TYPO3: Ein stufenweiser Ansatz
-----------------------------------------------------------------------------

Als robustes Enterprise Content Management-System verwaltet TYPO3 seine Einstellungen und Konfigurationen an mehreren verschiedenen Stellen. Um das System effektiv verwalten zu können, ist es wichtig, diese verschiedenen Ebenen der Konfiguration zu verstehen.

### Systemweite Einstellungen

Dies sind Einstellungen, die für die gesamte TYPO3-Installation relevant sind. Während TYPO3 tausende von verschiedenen Websites in einer einzigen Installation verwalten kann (erfahre mehr über [Multisite Management](https://typo3.org/cms/features/massively-multisite-multilingual)), sind grundlegende Konfigurationen wie Bildverarbeitung, Datenbankzugangsdaten und E-Mail-Einstellungen Teil dieser systemweiten Einstellungen.

Entwickler können diese Einstellungen im Rahmen von Erweiterungen — TYPO3s Methode zur Verbesserung seiner Kernfunktionalität — ausbauen. Du kannst sogar eigene systemweite Konfigurationen einführen, die neben den Standardeinstellungen gespeichert werden.

### Site-spezifische Einstellungen

Wenn du mehrere Websites mit einer einzigen TYPO3-Installation betreibst, sind standortspezifische Einstellungen von großem Nutzen. Bei b13 verwenden wir diese Einstellungen häufig, um bestimmte Speicherordner zu bestimmen, benutzerdefinierte CSS-Dateien zu integrieren oder verschiedene API-Tokens wie Google Recaptcha zu verwalten. Diese Site-Einstellungen können nahtlos in TypoScript-Konstanten umgewandelt werden, ein Feature, das sich als sehr praktisch erweist (weitere Details findest du unter [TypoScript Site Settings](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/SiteHandling/SiteSettings.html) in der offiziellen Dokumentation).

### Pro-Seite-Einstellungen

TYPO3 organisiert den Inhalt innerhalb eines hierarchischen Seitenbaums, der die Definition oder das Überschreiben von Einstellungen auf der Ebene der Verzweigungen ermöglicht. Dies wird durch TypoScript-Einträge („sys\_template“) in der Datenbank erreicht. Bei b13 ziehen wir es vor, die Verwendung von TypoScript-Einträgen einzuschränken, da sie nicht über Git, unser bevorzugtes Versionsverwaltungssystem, versionskontrolliert werden können. Stattdessen tendieren wir dazu, die meisten Funktionen in TypoScript-Dateien innerhalb von Erweiterungen einzubetten oder die „Site settings“ zu verwenden.

### Frühere Dateispeicherorte für Systemeinstellungen in TYPO3

Seit der Veröffentlichung von TYPO3 v6.0 hieß die primäre Konfigurationsdatei für globale systemweite Einstellungen LocalConfiguration.php. Diese als PHP-Array strukturierte Datei war insofern einzigartig, als dass sie nie zwischengespeichert wurde und sich im Verzeichnis TYPO3conf/ innerhalb des öffentlichen Ordners befand. Der Inhalt dieser Datei wurde direkt in $GLOBALS\[TYPO3\_CONF\_VARS\] geladen. TYPO3 lud diese Datei immer, ohne sie zu cachen — ein nützlicher Vorteil. Plus: Wenn sie nicht vorhanden war, ging TYPO3 von einer frischen, neuen Installation aus.

Für Konfigurationen, die bedingungsbasierte Änderungen erforderten, gab es eine optionale Datei namens AdditionalConfiguration.php.

Damals, im Jahr 2012, war dieses Konfigurationssystem ein großer Schritt nach vorn. Allerdings war es auch nicht ohne Nachteile:

- Obwohl es sich um eine globale Konfigurationsdatei handelte, enthielt sie seltsamerweise das Wort „Local“ in ihrem Namen.
- Da es sich um eine reine PHP-Datei handelte, stellte sie ein potenzielles Sicherheitsrisiko dar, wenn sie außerhalb des öffentlichen Stammverzeichnisses des Webservers gespeichert wurde. Fehlkonfigurationen könnten zu schwerwiegenden Sicherheitslücken führen und Unbefugten den Zugriff auf diese Dateien ermöglichen.

Auch die Installationsmethode von TYPO3 hatte Einfluss auf die Dateispeicherorte. Bei der Installation von TYPO3 über den Composer („Composer-Modus“) befanden sich verschiedene Quellcodes, einschließlich der Konfigurationsdateien, außerhalb des Dokument-Stammordners, der normalerweise „public“, „web“ oder „htdocs“ heißt. Im Gegensatz dazu konnten im „klassischen Modus“, bei dem TYPO3 aus einem Tarball installiert und auf dem Server entpackt wird, PHP-Dateien nicht ohne weiteres außerhalb des Dokumentenstamms verschoben werden. Allerdings war es im klassischen Modus immer noch möglich, den Zugriff auf nicht-öffentliche Ordner mit Hilfe von .htaccess-Dateien zu beschränken.

### Einführung des neuen Konfigurationsortes in TYPO3 v12

TYPO3 v9 markierte eine bedeutende Entwicklung mit der Einführung von Konfigurationsmöglichkeiten pro Site, die eine YAML-Datei zur Speicherung von Site-spezifischen Einstellungen und individuellen Konfigurationen verwenden. Im klassischen Modus von TYPO3 befindet sich diese Datei normalerweise unter TYPO3conf/sites/. Für diejenigen, die TYPO3 im Composer-Modus betreiben, wurde ein eigener Konfigurationsordner eingeführt, der in der Regel neben dem Ordner public oder htdocs liegt.

Mit der Einführung von TYPO3 v12 gibt es eine bemerkenswerte Veränderung in der Art und Weise, wie systemweite Konfigurationen gehandhabt werden. Diese Konfigurationen wurden nun an einem zentralen Ort zusammengefasst, in einem neu erstellten Ordner namens /system/, der sich unter dem Hauptkonfigurationsverzeichnis befindet. Diese Änderung vereinfacht nicht nur den Konfigurationsprozess, sondern entspricht auch den heutigen Anforderungen von TYPO3-Administratoren und Entwicklern.

**Für den Composer Mode:**

`{project-root}/config/system/settings.php (previously LocalConfiguration.php)`
`{project-root}/config/system/additional.php (previously AdditionalConfiguration.php)`

**Für den Classic Mode:**

`{project-root}/htdocs/typo3conf/system/settings.php (previously LocalConfiguration.php)`
`{project-root}/htdocs/typo3conf/system/additional.php (previously AdditionalConfiguration.php)`

   Umstellung auf die neue Konfiguration in TYPO3 v12
----------------------------------------------------

Die Migration auf TYPO3 v12 ist dank des intelligenten Designs, das den Migrationsprozess automatisiert, ein Kinderspiel. Wenn du zum ersten Mal auf das TYPO3 v12 Installationstool oder das Wartungsmodul zugreifst, verschiebt das System automatisch die betroffenen Einstellungsdateien an den neuen Speicherort. Dieser nahtlose Übergang bedeutet, dass keine manuellen Eingriffe erforderlich sind und du dir keine Sorgen machen musst.

**Wichtiger Hinweis für Git-Benutzer:**

Wenn du Git als Versionskontrollsystem verwendest, ist möglicherweise ein Update deiner .gitignore-Datei erforderlich. Mit dem Übergang zu TYPO3 v12 wird das Verzeichnis TYPO3conf/ im Composer-Modus obsolet. Aus diesem Grund solltest du alle Verweise auf TYPO3conf/ aus deiner .gitignore-Datei entfernen, um diese Änderung zu berücksichtigen. Dadurch wird sichergestellt, dass deine Versionskontroll-Einrichtung mit der aktualisierten TYPO3-Struktur übereinstimmt.

   Die Vorteile des Konfigurations-Updates von TYPO3 v12
-------------------------------------------------------

Das jüngste Update in TYPO3 v12 bringt eine deutliche Verbesserung in der Verwaltung der Systemeinstellungen. Die neue Namenskonvention und der neue Speicherort der Datei spiegeln genau ihren Zweck wider: Einstellungen zu speichern, die für die gesamte Installation gelten. Diese Klarheit steht in krassem Gegensatz zur historischen LocalConfiguration.php, einem Namen, der aus einer Zeit stammt, als TYPO3-Konfigurationen noch auf lokale Installationen in Shared Hosting-Umgebungen zugeschnitten waren. Dieses Relikt von vor zwei Jahrzehnten ist nun ersetzt und vereinfacht den Erklärungsprozess für neue Benutzer.

### Erhöhte Sicherheit im Composer-Modus

Die Einführung des Composer-Modus in TYPO3 v12 bringt eine zusätzliche Sicherheitsebene. Die Benutzer werden ein deutlich entschlacktes öffentliches Webroot vorfinden. Dank des neuen „[TYPO3/cms-composer-installers](https://packagist.org/packages/typo3/cms-composer-installers)„-Plugins werden nun alle nicht-essentiellen PHP-Dateien und -Konfigurationen außerhalb des Dokument-Root verschoben. Diese strategische Verlagerung erhöht die Sicherheit erheblich, da der Kern des Systems nur über bestimmte PHP-Dateien als Einstiegspunkt zugänglich ist. Eine solche Struktur reduziert von Natur aus Schwachstellen und stärkt die Installation.

   Nahtlose Integration mit b13/TYPO3-config
-------------------------------------------

Für diejenigen, die TYPO3 in Verbindung mit Git und CI/CD-Pipelines einsetzen, kann die Verwaltung unterschiedlicher Einstellungen in verschiedenen Umgebungen eine Herausforderung darstellen. Wir von b13 haben diesen Bedarf erkannt und eine schlanke Lösung entwickelt: die [b13/TYPO3-config](https://packagist.org/packages/b13/typo3-config) PHP-Bibliothek. Dieses Tool wurde entwickelt, um deinen Arbeitsablauf erheblich zu vereinfachen.

Dieses Composer-Paket überschreibt deine Standard-Einstellungsdatei mit kontextspezifischen Konfigurationen. Es verwendet einen anschaulicheren, flüssigeren und objektorientierten Ansatz für den Umgang mit allgemeinen Einstellungen. Das bedeutet, dass du dein TYPO3-Setup ganz einfach an verschiedene Entwicklungs-, Test- oder Produktionsumgebungen anpassen kannst, ohne die üblichen Probleme zu haben.

Die Integration von b13/TYPO3-config mit TYPO3 v12 schafft eine Synergie, die sowohl die Flexibilität als auch die Effizienz des Konfigurationsmanagements steigert. Sie ist ein Beispiel dafür, wie moderne Entwicklungspraktiken effektiv eingesetzt werden, um die Verwaltung von CMS-Plattformen auf Unternehmensebene wie TYPO3 reibungsloser und intuitiver zu gestalten.

   Brauchst du Hilfe? Wir sind für dich da!
------------------------------------------

Wenn du immer noch Probleme mit dem Upgrade deiner Installation auf die nächste Version hast, meld dich bei uns, damit wir dir helfen können.

 [ Get in touch. ](https://b13.com/de/kontakt)

  ###  Geschrieben von:

 ![Lächelnder Mann mit kurzen Haaren und einem Bart, der ein weinrotes Hemd trägt, steht in einer modernen Innenumgebung mit unscharfen Hintergrundelementen.](https://b13.com/fileadmin/_processed_/c/6/csm_benni_66cce9a81f.webp)

Der Mitbegründer von b13 und Leiter des TYPO3 CMS Core Developement, Benni Mack, bestimmt maßgeblich unsere technischen Best-Practises. Er ist zuständig für den Aufbau und die Wartung unserer technischen Infrastruktur und koordiniert unseren Beitrag zum Open-Source-Projekt. Sein wesentliches Werkzeug: TYPO3

 Benni Mack  CTO

 [ mehr von Benni Mack ](https://b13.com/de/team/benni-mack)

  Ähnliche Artikel
------------------

- ![Cartoon-Trophäenfigur umgeben von Händen, die Daumen hoch und ein Herzzeichen geben, vor einem Hintergrund mit Zahnradmuster.](https://b13.com/fileadmin/_processed_/f/7/csm_T3ppy_Design_Kit_Headerbild_b51eb9dc31.webp)

    ###  T3ppy gibt TYPO3 ein freundliches Gesicht

     06. August 2026 | Florian “Flix” Keitgen

     TYPO3 ist leistungsstark — muss sich aber nicht unpersönlich anfühlen. Das ist T3ppy, unser freundlicher Begleiter fürs Backend.

     [ weiterlesen: T3ppy gibt TYPO3 ein freundliches Gesicht ](https://b13.com/de/wissen/t3ppy-design-kit)
- ![Hammer mit der Aufschrift 'KI' auf einem schaltkreis-musternden Hintergrund mit gelben Sternen, der Regulierung oder Gesetzgebung im Zusammenhang mit künstlicher Intelligenz in der EU symbolisiert.](https://b13.com/fileadmin/_processed_/1/0/csm_EUAIAct_Headerbild_510724b3de.webp)

    ###  KI-Inhalte in TYPO3: Transparenz braucht Verantwortung

     02. August 2026 | Benni Mack

     Der EU AI Act rückt die Herkunft KI-generierter Inhalte in den Fokus. AI Label kennzeichnet KI-generierte und KI-bearbeitete Inhalte in TYPO3 und dokumentiert, wer den…

     [ weiterlesen: KI-Inhalte in TYPO3: Transparenz braucht Verantwortung ](https://b13.com/de/wissen/ai-content-in-typo3-labelling-needs-accountability)
- ![Eine Reihe stilisierter Figuren in verschiedenen Posen, jede mit einem markanten orangefarbenen Hut, zeigt einen Übergang vom Gehen zum Stillstehen, während sie auf ein Handy schauen, vor einem lila Gitterhintergrund.](https://b13.com/fileadmin/_processed_/d/7/csm_QueuesDDEV_Headerbild_f640931350.webp)

    ###  Bessere Skalierbarkeit mit entkoppelten Queues: So richtest du RabbitMQ mit TYPO3 ein

     10. April 2024 | Jochen Roth

     Wenn integrierte Nachrichtentransporte an ihre Grenzen stoßen, kann RabbitMQ TYPO3 mit einer skalierbaren, robusten Message Queue versorgen.

     [ weiterlesen: Bessere Skalierbarkeit mit entkoppelten Queues: So richtest du RabbitMQ mit TYPO3 ein ](https://b13.com/de/wissen/bessere-skalierbarkeit-mit-entkoppelten-queues-so-richtest-du-rabbitmq-mit-typo3-ein)
- ![Eine Cartoonfigur, die einem Schild ähnelt, gibt ein Daumen hoch vor einer Computeroberfläche mit verschiedenen Menüoptionen.](https://b13.com/fileadmin/_processed_/e/6/csm_Header_cda1f80173.webp)

    ###  Gestatten, T3ppy! Ein neues Zeitalter für die Redaktionsarbeit in TYPO3

     01. April 2026 | Florian “Flix” Keitgen

     Entdecke T3ppy und AiM — Deine KI-Assistenz im TYPO3 Backend für bessere Inhalte, klare Strukturen und volle Kontrolle über Redaktions-Prozesse.

     [ weiterlesen: Gestatten, T3ppy! Ein neues Zeitalter für die Redaktionsarbeit in TYPO3 ](https://b13.com/de/wissen/gestatten-t3ppy-ein-neues-zeitalter-fuer-die-redaktionsarbeit-in-typo3)
- ![Retro-Mikrofon-Illustration mit einem Einkaufswagen-Symbol im Hintergrund, das E-Commerce oder Online-Shopping symbolisiert.](https://b13.com/fileadmin/_processed_/f/8/csm_Marketplace_Headerbild_ee1575614c.webp)

    ###  Warum TYPO3 einen Marketplace für Produkte braucht

     25. März 2026 | Florian “Flix” Keitgen

     Ein Marketplace würde TYPO3-Produkte sichtbarer machen, den Vergleich erleichtern und Agenturen sowie Kunden gleichermaßen profitieren lassen.

     [ weiterlesen: Warum TYPO3 einen Marketplace für Produkte braucht ](https://b13.com/de/wissen/warum-typo3-einen-marketplace-fuer-produkte-braucht)
- ![Eine Hand hält eine Lupe über den Laptop-Bildschirm, der eine Webseite mit einem Bild und Textelementen anzeigt.](https://b13.com/fileadmin/_processed_/e/5/csm_BackendUserSection_Headerbild_6093c842fd.webp)

    ###  Ein echter Geheimtipp in TYPO3: Die Backend User Section (Doktype 6)

     05. März 2026 | David Steeb

     Entdecke den oft unterschätzten Doktype 6 (Backend User Section) in TYPO3 für sichere interne Vorschauen, Redaktionstrainings und Prototyping. Erfahre praxisnahe Anwendungsfälle,…

     [ weiterlesen: Ein echter Geheimtipp in TYPO3: Die Backend User Section (Doktype 6) ](https://b13.com/de/wissen/ein-echter-geheimtipp-in-typo3-die-backend-user-section-doktype-6)
- ![Zwei stilisierte Webseiten-Designs mit einem Benutzerprofil, Platzhaltern für Bilder und Textabschnitten, vor einem hellblauen Hintergrund.](https://b13.com/fileadmin/_processed_/2/0/csm_BackendPreview_Headerbild_b4c5799cfa.webp)

    ###  Backend-Content-Previews mit System — warum wir EXT:backendpreviews entwickelt haben

     09. Februar 2026 | David Steeb

     EXT:backendpreviews sorgt für konsistente Content-Previews im TYPO3-Backend mit Fluid Templates, Layouts und Partials.

     [ weiterlesen: Backend-Content-Previews mit System — warum wir EXT:backendpreviews entwickelt haben ](https://b13.com/de/wissen/backend-content-previews-mit-system-warum-wir-extbackendpreviews-entwickelt-haben)
- ![Eine menschliche Hand schüttelt eine Roboterhand vor einem lila Hintergrund mit Herzmustern, was die Zusammenarbeit zwischen Menschen und Technologie symbolisiert.](https://b13.com/fileadmin/_processed_/6/2/csm_AIbotsLoveMarkdown_Headerbild_72fe5820d6.webp)

    ###  Das Internet ist nicht mehr nur für Menschen — KI-Bots lieben Markdown

     28. Januar 2026 | Benni Mack

     Discover why most web traffic is now automated and how TYPO3’s structured content model prepares websites for humans, editors, and AI systems.

     [ weiterlesen: Das Internet ist nicht mehr nur für Menschen — KI-Bots lieben Markdown ](https://b13.com/de/wissen/das-internet-ist-nicht-mehr-nur-fuer-menschen-ki-bots-lieben-markdown)
- ![Mehrere farbenfrohe Mockups von Webseiten, die übereinander gestapelt sind und verschiedene Layouts sowie Designelemente vor einem lila Hintergrund präsentieren.](https://b13.com/fileadmin/_processed_/e/3/csm_CaminoTheme_Headerbild_d082598009.webp)

    ###  Camino—The Need for a Default Theme in TYPO3 Is Real

     27. Januar 2026 | Benni Mack

     With TYPO3 v14, Camino introduces a default theme that removes friction from first installs. Why this matters—and how TYPO3 laid the groundwork.
- ![Grafik mit stilisierten Darstellungen eines Turms, in dessen Mitte der Text "T3CON25 Düsseldorf" deutlich sichtbar ist.](https://b13.com/fileadmin/_processed_/7/b/csm_T3CON2025_Headerbild_fc9c5cc53e.webp)

    ###  T3CON25 — der Zukunft des Content Managements einen Schritt näher

     10. Dezember 2025 | Franzi Töpler

     Die T3CON25 zeigte die Zukunft von TYPO3 mit Einblicken in TYPO3 v14, KI, digitale Souveränität und Open-Source-Lösungen für moderne, sichere Webauftritte.

     [ weiterlesen: T3CON25 — der Zukunft des Content Managements einen Schritt näher ](https://b13.com/de/wissen/t3con25-der-zukunft-des-content-managements-einen-schritt-naeher)