.env · umwandeln🔒 100 % im Browser – verlässt nie dein Gerät

JSON-zu-ENV-Konverter

JSON in eine .env-Datei umwandeln, mit einem Einfügen: Dieser JSON-zu-ENV-Konverter macht aus verschachtelten Objekten Schlüssel in UPPER_SNAKE_CASE, setzt Werte in Anführungszeichen, die einen dotenv-Parser sonst aus dem Tritt bringen, und läuft komplett in deinem Browser.

Von Aliniyaz Mamat · zuletzt geprüft am

DATABASE_URL=postgres://user:pass@localhost:5432/db
PORT=3000
DEBUG=true
STRIPE_SECRET_KEY=sk_test_xxx
STRIPE_WEBHOOK=whsec_xxx

Das Wichtigste in Kürze

  • ✓Verschachtelte Schlüssel werden mit _ verbunden und großgeschrieben: aus database.url wird DATABASE_URL.
  • ✓Werte mit Leerzeichen, #, Anführungszeichen, $ oder Zeilenumbrüchen landen in doppelten Anführungszeichen, damit abc#123 nicht am # abgeschnitten wird.
  • ✓Arrays bleiben ein JSON-String (["a","b"]), weil ein .env-Wert immer ein einzelner String ist.
  • ✓Typen gehen verloren: 3000 und true werden zu Strings; deine App muss sie selbst wieder umwandeln.
  • ✓Es wird nichts hochgeladen. Die Umwandlung ist reines JavaScript in diesem Tab, wichtig, wenn das JSON Secrets enthält.

Was das Tool macht

  • ▸Wandelt jedes JSON-Objekt in eine gültige .env-Datei um
  • ▸Verschachtelte Objekte werden zu UPPER_SNAKE_CASE-Schlüsseln, verbunden mit _
  • ▸Ersetzt Zeichen, die in Variablennamen ungültig sind (Punkte, Bindestriche, Leerzeichen), durch _
  • ▸Setzt Werte mit Leerzeichen, #, Anführungszeichen, $ oder Zeilenumbrüchen in Anführungszeichen
  • ▸Als .env kopieren oder herunterladen, 100 % im Browser

Datenschutz

Läuft zu 100 % in deinem Browser. Deine .env erreicht nie unsere Server.

nur im Browser

Anwendungsbeispiele

Fall 1 · Verschachtelte Config → flache Schlüssel
{
  "database": { "url": "postgres://app@localhost:5432/app" },
  "auth": { "jwt_secret": "s3cr3t" },
  "port": 3000
}
DATABASE_URL=postgres://app@localhost:5432/app
AUTH_JWT_SECRET=s3cr3t
PORT=3000
Fall 2 · Problematische Zeichen werden gequotet
{
  "smtp": { "password": "abc#123" },
  "app_name": "My App"
}
SMTP_PASSWORD="abc#123"
APP_NAME="My App"
Fall 3 · Arrays und null
{
  "allowed-origins": ["https://a.com", "https://b.com"],
  "sentry_dsn": null
}
ALLOWED_ORIGINS="[\"https://a.com\",\"https://b.com\"]"
SENTRY_DSN=

Wann du das Tool brauchst

  • →Umstieg von einer config.json oder einer appsettings-Datei auf Umgebungsvariablen
  • →Die Ausgabe von firebase functions:config:get in eine .env für Functions v2 übertragen
  • →Eine lokale .env aus einem JSON-Export eines Secrets-Managers erstellen (AWS Secrets Manager, Doppler, 1Password CLI)
  • →JSON-Einstellungen an docker run --env-file oder ein Kubernetes-Secret übergeben

Häufige Fehler

  • ⚠Erwarten, dass Arrays wieder Arrays werden. Ein .env-Wert ist ein String; parse ihn in der App mit JSON.parse
  • ⚠Vergessen, dass Zahlen und Booleans zu Strings werden: process.env.PORT ist "3000", nicht 3000
  • ⚠Schlüssel-Kollisionen: {"a_b": 1, "a": {"b": 2}} ergeben beide A_B, der letzte gewinnt
  • ⚠Die erzeugte .env committen. Trage sie in .gitignore ein, bevor du sie im Projekt speicherst

So funktioniert die Umwandlung von JSON in .env

Eine .env-Datei ist eine flache Liste von KEY=value-Zeilen, JSON dagegen kann Objekte beliebig tief verschachteln. Der Konverter geht das Objekt durch und erzeugt pro Endwert eine Variable. Jede Ebene tiefer hängt den Schlüssel und einen Unterstrich an den Namen an.

  1. Flach machen: {"stripe": {"webhook": {"secret": "whsec_…"}}} wird zum Pfad stripe_webhook_secret.
  2. Namen normalisieren: Der Pfad wird großgeschrieben und jedes Zeichen außer A-Z, 0-9 und _ wird zu _, aus allowed-origins wird also ALLOWED_ORIGINS.
  3. Wert schreiben: Strings und Zahlen werden übernommen, null wird zu einem leeren Wert, Arrays werden zu einem JSON-String.
  4. Bei Bedarf quoten: Ein Wert mit Leerzeichen, #, Anführungszeichen, $, Backslash oder Zeilenumbruch kommt in doppelte Anführungszeichen; innere doppelte Anführungszeichen werden escaped.

Du brauchst die Gegenrichtung? Der ENV-zu-JSON-Konverter macht aus einer .env wieder ein Objekt und kann "true" und "3000" zurück in echte Booleans und Zahlen umwandeln.

Was sich ändert, wenn JSON zur .env-Datei wird

JSON-Eingabe.env-AusgabeWas deine App bekommt
"port": 3000PORT=3000den String "3000"
"debug": trueDEBUG=trueden String "true" (wahr, selbst wenn dort "false" steht)
"tags": ["a","b"]TAGS="[\"a\",\"b\"]"einen JSON-String, mit JSON.parse lesen
"dsn": nullDSN=einen leeren String, bei manchen Loadern undefined
"db": {"url": "…"}DB_URL=…eine flache Variable pro Endwert

Am sichersten ist es, einmal beim Start zu validieren und umzuwandeln, zum Beispiel mit zod in Node.js oder pydantic-settings in Python, statt überall im Code Number() aufzurufen. Der .env-Validator findet fehlerhafte Zeilen, bevor es deine App tut.

JSON auf der Kommandozeile in .env umwandeln

Für ein flaches JSON-Objekt ohne Verschachtelung erledigt jq das in CI-Pipelines:

# flat object only: {"PORT": 3000, "NODE_ENV": "production"}
jq -r 'to_entries[] | "\(.key)=\(.value)"' config.json > .env

# AWS Secrets Manager (SecretString is a JSON object)
aws secretsmanager get-secret-value --secret-id prod/app \
  --query SecretString --output text \
  | jq -r 'to_entries[] | "\(.key)=\(.value)"' > .env

Diese Einzeiler machen verschachtelte Objekte nicht flach und setzen Werte mit # oder Leerzeichen nicht in Anführungszeichen. Für alles Verschachtelte oder mit Passwörtern füge das JSON oben in den Konverter ein und schick das Ergebnis danach durch den .env-Formatter, wenn du es ausgerichtet und sortiert haben möchtest.

Häufige Fragen

Wie werden verschachtelte JSON-Objekte zu .env-Schlüsseln?

Jede Ebene wird mit einem Unterstrich verbunden und das Ergebnis großgeschrieben, aus {"database": {"url": "…"}} wird also DATABASE_URL=…. Das Trennzeichen ist immer _, die Konvention, die die meisten Config-Bibliotheken erwarten.

Werden JSON-Arrays unterstützt?

Ja, sie bleiben aber ein String. ["a","b"] wird als gequoteter JSON-String geschrieben, weil dotenv keinen Array-Typ kennt. Lies ihn mit JSON.parse(process.env.TAGS) oder nutze stattdessen einen kommagetrennten Wert.

Warum stehen manche Werte in Anführungszeichen?

Ohne Anführungszeichen behandelt dotenv # als Kommentarbeginn und verwirft es samt allem danach, und Zeilenumbrüche beenden den Wert. Der Konverter quotet solche Werte, damit sie unverändert ankommen.

Kann ich die .env zurück in JSON umwandeln?

Ja, mit dem ENV-zu-JSON-Konverter. Die Verschachtelung kommt dabei nicht automatisch zurück: DATABASE_URL bleibt ein Schlüssel auf oberster Ebene, weil der Unterstrich auch Teil des ursprünglichen Namens sein könnte.

Kann ich Secrets gefahrlos in diesen Konverter einfügen?

Die Seite rechnet in deinem Browser und schickt nichts an einen Server. Das kannst du im Netzwerk-Tab der DevTools nachprüfen, während du einfügst. Behandle das Ergebnis trotzdem wie jedes Secret: nicht in Chats einfügen und nicht committen.

Verwandte Tools

Mehr erfahren

Vergleiche