Was ist eine INI-Datei? Aufbau, Sektionen und wofür man sie nutzt

Was ist eine INI-Datei? Die Definition

Die Abkürzung INI leitet sich vom englischen Wort initialization ab, also Initialisierung. Eine INI-Datei ist nichts weiter als eine reine Textdatei, die Einstellungen für ein Programm oder ein System speichert. Sie trägt üblicherweise die Dateiendung .ini, gelegentlich auch .cfg oder .conf. Der Inhalt ist so aufgebaut, dass ein Mensch ihn ohne Spezialwissen lesen und ändern kann, und genau das ist der Sinn des Formats.

Im Kern besteht eine INI-Datei aus drei Bausteinen: Sektionen, die thematisch zusammengehörende Einstellungen bündeln, Schlüssel-Wert-Paaren, die die eigentlichen Einstellungen enthalten, und optionalen Kommentaren, die der Erklärung dienen. Ein kleines Beispiel macht das greifbar. Eine typische config.ini sieht im Texteditor so aus:

; Konfiguration der Anwendung
[server]
host=localhost
port=8080
debug=true

[database]
name=produktion
user=admin
timeout=30

Die Zeile [server] ist eine Sektion, darunter folgen drei Schlüssel-Wert-Paare. Die erste Zeile mit dem Semikolon ist ein Kommentar, den das Programm beim Einlesen ignoriert. Schon an diesem winzigen Beispiel sehen Sie, warum INI so beliebt ist: Es ist sofort verständlich, auch ohne die Anwendung zu kennen.

Woher INI kommt: ein Stück Software-Geschichte

Das INI-Format wurde in den frühen Tagen von Microsoft Windows populär. Schon unter Windows 3.x speicherten das System und die Programme ihre Einstellungen in Dateien wie win.ini und system.ini. Anwendungen legten ihre eigenen .ini-Dateien an, um Pfade, Fenstergrößen oder zuletzt geöffnete Dateien festzuhalten. Mit Windows 95 verlagerte Microsoft viele dieser Einstellungen in die zentrale Registry, doch das INI-Format verschwand nie. Es ist bis heute weit verbreitet, weil es einen entscheidenden Vorteil hat, den die Registry nicht bietet: Eine INI-Datei ist portabel, leicht zu sichern und mit jedem Editor zu bearbeiten.

Anders als bei JSON oder XML gibt es für INI keinen einzigen, formell verabschiedeten Standard, der jedes Detail festlegt. Das Format hat sich organisch entwickelt, und so existieren heute mehrere Dialekte, die sich in Kleinigkeiten unterscheiden. Auf diese Unterschiede gehen wir weiter unten genauer ein, denn sie sind beim Umwandeln in andere Formate die häufigste Stolperfalle.

Wie ist eine INI-Datei aufgebaut?

Trotz fehlendem Einheitsstandard folgt der Aufbau einer klaren, einfachen Logik. Die Bausteine im Überblick:

Wichtig zu verstehen: Schlüssel und Wert werden am ersten Gleichheitszeichen getrennt. Steht im Wert selbst ein weiteres =, etwa in einer URL oder einem Pfad, gehört es noch zum Wert. Führende und nachfolgende Leerzeichen um Schlüssel und Wert werden meist entfernt, sodass port = 8080 und port=8080 dasselbe bedeuten. Schlüssel-Wert-Paare, die ganz oben in der Datei vor der ersten Sektion stehen, gehören zu einer gedachten obersten Ebene ohne Sektionsnamen.

Sektionen und verschachtelte Sektionen

Sektionen sind das Ordnungsprinzip einer INI-Datei. Alles, was unter einem [abschnitt] steht, gehört zu diesem Abschnitt, bis die nächste Sektion beginnt. Das hält große Konfigurationsdateien übersichtlich. Manche Dialekte erlauben darüber hinaus verschachtelte Sektionen mittels Punktnotation, etwa:

[server.database]
host=db.example.com
port=5432

[server.cache]
host=redis.example.com
port=6379

Hier deuten server.database und server.cache eine Hierarchie an: Beide gehören logisch zu server. Wandelt man eine solche Datei mit aktivierter Verschachtelungs-Option in JSON um, entsteht daraus ein verschachteltes Objekt mit einem server auf oberster Ebene, das wiederum database und cache enthält. Wie diese Abbildung im Detail funktioniert, beschreibt der Ratgeber Verschachtelte INI-Sektionen in JSON abbilden.

Kommentare, Anführungszeichen und Datentypen

Eine der angenehmen Eigenschaften von INI sind Kommentare. Sie helfen, eine Konfigurationsdatei zu dokumentieren, ohne die Funktion zu verändern. Üblich sind zwei Kommentarzeichen: das Semikolon ; (klassisch unter Windows) und die Raute # (verbreitet in Unix-naher Software wie git oder vielen Linux-Tools). Beide markieren eine Zeile als Kommentar.

Werte können bei Bedarf in Anführungszeichen stehen. Das ist nützlich, wenn ein Wert führende oder nachfolgende Leerzeichen behalten soll oder Sonderzeichen enthält, etwa pfad="C:\Programme\Meine App". Ein guter Parser entfernt die umschließenden Anführungszeichen beim Einlesen und gibt den reinen Wert zurück.

Der entscheidende Punkt, den viele übersehen: INI kennt keine Datentypen. Für die Datei ist jeder Wert erst einmal Text. Ob port=8080 eine Zahl meint oder debug=true einen Wahrheitswert, weiß die Datei selbst nicht. Erst das einlesende Programm interpretiert die Werte. Beim Umwandeln nach JSON, das echte Datentypen kennt, wendet ein Konverter daher eine Heuristik an: true und false werden zu Booleans, reine Zahlen zu Zahlen, alles andere bleibt String. Diese Heuristik lässt sich abschalten, wenn man jeden Wert verlustfrei als Text behalten will. Mehr dazu im Ratgeber INI-Datentypen in JSON.

Wofür man INI nutzt: typische Einsatzorte

INI ist das Brot-und-Butter-Format für Konfiguration. Überall dort, wo ein Programm wenige bis mittel viele Einstellungen lesbar ablegen will, ist INI eine naheliegende Wahl. Typische Einsatzgebiete:

• Windows-Konfiguration: Dateien wie desktop.ini steuern, wie Ordner im Explorer angezeigt werden. Auch viele klassische Windows-Programme legen ihre Einstellungen als INI ab.
• Spiele: Unzählige PC-Spiele speichern Grafik-, Sound- und Steuerungseinstellungen in INI-Dateien. Wer schon einmal Grafikoptionen von Hand getunt hat, hat dafür meist eine INI bearbeitet.
• php.ini: Die zentrale Konfigurationsdatei der Programmiersprache PHP. Sie legt fest, wie viel Speicher Skripte nutzen dürfen, wie groß Uploads sein dürfen und vieles mehr. Details im Ratgeber php.ini verstehen.
• git config: Die Konfiguration von git nutzt ein INI-ähnliches Format mit Sektionen wie [user] oder [core].
• systemd-Units: Auf Linux beschreiben Unit-Dateien (Dienste, Timer) ihr Verhalten in einem INI-nahen Format mit Sektionen wie [Unit] und [Service].
• Allgemeine Anwendungs-Einstellungen: Viele Desktop- und Serverprogramme nutzen eine schlichte config.ini oder settings.ini.

Der gemeinsame Nenner: Es geht um Einstellungen, nicht um große Datenmengen. INI glänzt bei überschaubaren, von Menschen gepflegten Konfigurationen. Für komplexe, tief verschachtelte oder maschinell ausgetauschte Daten greift man eher zu JSON oder YAML, was der Ratgeber INI, YAML oder JSON gegenüberstellt.

INI ist nicht gleich INI: die Dialekte

Weil es keinen einzigen verbindlichen Standard gibt, verhalten sich verschiedene INI-Dialekte in Details unterschiedlich. Die wichtigsten Unterschiede betreffen:

• Kommentarzeichen: mal nur Semikolon, mal nur Raute, mal beides. Manche Dialekte erlauben Kommentare auch am Ende einer Wert-Zeile, andere nur in eigenen Zeilen.
• Groß- und Kleinschreibung: Manche Parser behandeln Port und port als denselben Schlüssel, andere unterscheiden sie.
• Anführungszeichen: ob sie unterstützt werden und wie sie behandelt werden, ist nicht einheitlich.
• Mehrfache Schlüssel: einige Dialekte erlauben denselben Schlüssel mehrfach in einer Sektion und fassen die Werte zu einer Liste zusammen, andere überschreiben den vorherigen Wert.
• Verschachtelte Sektionen: die Punktnotation [a.b] ist nicht überall vorgesehen.

Für die Praxis bedeutet das: Wenn Sie eine fremde INI-Datei umwandeln oder weiterverarbeiten, sollten Sie wissen, aus welcher Welt sie stammt. Unser Konverter nutzt eine gängige, klar dokumentierte Auslegung (Sektionen, key=value, Kommentare mit ; und #). Bei exotischen Dialekten kann das Ergebnis abweichen, worauf der Ratgeber INI-Dialekte und Grenzen ausführlich eingeht.

INI-Datei öffnen und bearbeiten

Eine INI-Datei öffnen ist denkbar einfach, denn es ist ja nur Text. Je nach Ziel bieten sich verschiedene Wege an:

1. Mit einem Texteditor: Unter Windows der Editor (Notepad), auf dem Mac TextEdit, plattformübergreifend Notepad++ oder VS Code. Diese zeigen den Rohinhalt und eignen sich zum Lesen wie zum Ändern.
2. Auf das Encoding achten: Speichern Sie INI-Dateien als UTF-8, damit Umlaute wie ä, ö, ü und das ß korrekt bleiben. Ein falscher Zeichensatz macht aus Größe schnell unleserlichen Zeichensalat.
3. Vorsicht bei Editoren, die formatieren: Schreibprogramme wie Word eignen sich nicht, weil sie versteckte Formatierung einfügen können. Nutzen Sie einen reinen Texteditor.
4. Zum Prüfen in JSON umwandeln: Wenn Sie eine INI-Datei strukturell verstehen oder maschinell prüfen wollen, hilft die Umwandlung nach JSON, weil die Struktur dort eindeutig sichtbar wird.

Eine ausführliche Schritt-für-Schritt-Anleitung zum Öffnen und Bearbeiten auf verschiedenen Systemen finden Sie im Ratgeber INI-Datei öffnen und bearbeiten.

Vorteile und Grenzen des Formats

So nützlich INI ist, das Format hat klare Grenzen. Ehrlich betrachtet sieht die Bilanz so aus:

Die fehlende tiefe Verschachtelung ist die häufigste Praxisgrenze. INI ist flach, abgesehen von der Punktnotation, die einige Dialekte erlauben. Sobald Daten viele Ebenen tief verschachteln, mehrere Listen mischen oder ein null brauchen, stößt INI an seine Wand. Genau dort beginnt die Stärke von JSON.

Von INI zu JSON

Wer eine INI-Datei programmatisch verarbeiten, in eine moderne Anwendung einbinden oder strukturell prüfen möchte, kommt schnell zu JSON. JSON kennt echte Datentypen und beliebige Verschachtelung und ist das Standardformat für den Datenaustausch zwischen Programmen. Was JSON genau ist, erklärt der Ratgeber Was ist JSON, und den direkten Vergleich liefert INI oder JSON.

Die Umwandlung selbst übernimmt unser INI-zu-JSON-Konverter: Er liest Ihre INI-Datei, erkennt Sektionen und Schlüssel-Wert-Paare, löst auf Wunsch verschachtelte Sektionen auf und erzeugt sauberes JSON in der gewünschten Einrückung. Das geschieht zu 100 Prozent lokal in Ihrem Browser, ohne Upload und ohne Anmeldung, Ihre Datei verlässt Ihr Gerät also nicht. Das ist besonders wichtig, weil Konfigurationsdateien oft Passwörter oder Schlüssel enthalten. Den kompletten Ablauf zeigt der Ratgeber INI in JSON umwandeln.

Häufige Fragen

Quellen und Methodik

Dieser Ratgeber beruht auf der gängigen Praxis im Umgang mit INI-Konfigurationsdateien (Windows-INI, git config, php.ini und systemd-Units) sowie auf dem dokumentierten Verhalten unseres eigenen Konverters. Da INI kein formell verabschiedeter Standard ist, beschreiben wir eine verbreitete, klar definierte Auslegung und weisen offen auf abweichende Dialekte hin. Die Beispiele sind eigene, getestete Konfigurationen. Geprüft am 25.06.2026.