Konfiguration
Free & PremiumAuf der Seite Konfiguration bearbeitest du die Konfigurationsdateien deiner lokalen Umgebung, ohne sie in der Sandbox suchen zu müssen: die php.ini jeder PHP-Version, my.cnf, redis.conf, die Dateien der Webserver und weitere. Dazu kommen Dateien deines Benutzerkontos wie .zshrc oder ssh/config und beliebige Textdateien, die du selbst einträgst. WebDonkey hebt bei jedem Speichern die vorherige Fassung auf, du kannst also jederzeit zurück.
Was du hier machst
- Konfigurationsdateien bearbeiten:
php.ini,fpm.conf,my.cnfund die übrigen Dateien deiner Dienste ändern, auch die gemeinsame php.ini für alle PHP-Versionen. - Systemdateien und eigene Dateien: Shell-, SSH-, Git- und Paketmanager-Dateien deines Kontos bearbeiten und eigene Textdateien in die Liste aufnehmen.
- Werte-Katalog Quick-Add: gängige Einstellungen mit einem Klick einfügen, statt die Schreibweise nachzuschlagen.
- Frühere Fassungen und Konflikte: eine ältere Fassung vergleichen und zurückholen, und was passiert, wenn jemand die Datei gleichzeitig ändert.
Aufbau der Seite
Die Seite hat drei Spalten. Jede scrollt für sich, die Seite selbst bleibt stehen.
| Bereich | Inhalt |
|---|---|
| Links | Die Dateiliste mit drei aufklappbaren Bereichen: Service-Konfigurationen, Eigene Konfigurationen und Systemdateien. Es ist immer genau einer offen. Ein Klick auf eine Überschrift öffnet diesen Bereich und schließt den anderen. |
| Mitte | Der Editor mit Syntax-Hervorhebung. In seiner Kopfzeile stehen Name und Pfad der Datei, Frühere Fassungen und Speichern. Nach dem Speichern steht dort gespeichert · Uhrzeit. |
| Rechts | Der Katalog Quick-Add. Er erscheint nur bei Dateien, für die es einen Katalog gibt. |
Ungespeicherte Änderungen gehen nicht verloren, wenn du zwischendurch eine andere Seite öffnest. WebDonkey hält sie je Datei fest, bis du speicherst oder die App beendest.
WebDonkey legt Konfigurationsdateien an, wenn sie fehlen, und lässt deine Werte danach stehen. In einzelnen Dateien pflegt die App nur die Zeilen, die zur Sandbox gehören, etwa die Pfade in my.cnf. Die drei Hauptdateien der Webserver schreibt WebDonkey dagegen bei jedem Start neu. Sie sind hier schreibgeschützt, siehe Konfigurationsdateien bearbeiten.
Free und Premium
Fast alles auf dieser Seite ist in Free enthalten. Nur die gemeinsame php.ini für alle PHP-Versionen (php (alle Versionen) · common.ini) bearbeitest du mit Premium. In Free trägt sie in der Liste das Premium-Zeichen und öffnet sich nur lesbar. Die php.ini jeder einzelnen PHP-Version bleibt in Free bearbeitbar.
Konfigurationsdateien bearbeiten Free & Premium
Unter Service-Konfigurationen stehen die Konfigurationsdateien der Dienste, die WebDonkey für dich betreibt. Du änderst sie im Editor der App und speicherst mit einem Klick. Damit eine Änderung wirkt, startest du den Dienst danach neu. WebDonkey sichert vor jedem Speichern die bisherige Fassung und lehnt eine fpm.conf ab, mit der PHP nicht mehr starten würde.
So findest du es
Seitenleiste Lokal › Konfiguration. Der Bereich Service-Konfigurationen links ist beim ersten Öffnen aufgeklappt, die oberste Datei ist gewählt. Über ⌘K findest du die Seite mit Suchwörtern wie „php.ini“ oder „Konfiguration“.
So gehst du vor
- Klick links in Service-Konfigurationen auf die Datei, zum Beispiel php 8.4.25 · php.ini.
- Ändere den Text im Editor. Oben stehen Name und vollständiger Pfad der Datei.
- Klick Speichern. Der Knopf ist nur aktiv, wenn sich dein Text vom gespeicherten Stand unterscheidet. Danach steht daneben gespeichert · Uhrzeit.
- Starte den betroffenen Dienst neu, damit er die Datei neu liest (siehe unten).
Brauchst du eine Einstellung, deren Schreibweise du nicht im Kopf hast, nimm den Werte-Katalog Quick-Add rechts.
Welche Dateien in der Liste stehen
Ganz oben steht immer die gemeinsame php.ini, danach folgen alle anderen Dateien alphabetisch.
| Eintrag | Wofür |
|---|---|
| php (alle Versionen) · common.ini | Gemeinsame php.ini für jede PHP-Version (Premium, siehe unten) |
php <Version> · php.ini |
Die php.ini einer installierten PHP-Version, je Version ein Eintrag |
php <Version> · fpm.conf |
Die Einstellungen von PHP-FPM für diese Version, etwa die Zahl der Worker |
| mysql · my.cnf, mariadb · my.cnf | Server-Einstellungen von MySQL und MariaDB |
| postgres · postgresql.conf | Server-Einstellungen von PostgreSQL. Die Datei liegt im Datenverzeichnis von PostgreSQL |
| redis · redis.conf, memcached · memcached.args | Cache-Dienste |
| mongodb · mongod.conf | MongoDB |
| meilisearch · config.toml, opensearch · opensearch.yml, opensearch · jvm.options | Suchdienste |
| minio · minio.env | MinIO (S3-kompatibler Speicher) |
| rabbitmq · rabbitmq.conf, rabbitmq · enabled_plugins | RabbitMQ |
| nginx · nginx.conf, apache · httpd.conf, caddy · Caddyfile | Hauptdateien der Webserver, nur lesbar |
| nginx · custom.conf, apache · custom.conf, caddy · custom.caddy | Deine eigenen Webserver-Einstellungen |
Die Liste zeigt die Dateien aller Dienste, die WebDonkey kennt, auch wenn ein Dienst noch nie gestartet wurde. Bei PHP stehen nur die Versionen, die installiert sind. Gibt es eine Datei noch nicht, trägt sie das Zeichen neu. Speicherst du sie, legt WebDonkey sie an.
Wann eine Änderung wirkt
Ein Dienst liest seine Konfiguration beim Start. Speichern allein ändert also noch nichts am laufenden Dienst.
- PHP auf der Kommandozeile (Terminal, Composer, geplante Aufgaben) liest die php.ini bei jedem Aufruf neu. Die Änderung gilt sofort.
- PHP für Webseiten läuft über PHP-FPM, das die Einstellungen im Speicher hält. Starte den PHP-Dienst neu.
- Datenbanken, Webserver und alle anderen Dienste übernehmen die Änderung nach einem Neustart.
Einen einzelnen Dienst startest du auf der Seite Services neu. Neustart in der oberen Leiste stoppt alle Dienste und startet die zuvor aktiven wieder, praktisch nach mehreren Änderungen auf einmal.
Webserver: Hauptdatei und eigene Datei
nginx.conf, httpd.conf und das Caddyfile schreibt WebDonkey bei jedem Start, jedem Neuladen und jeder Änderung an einer Site neu. Darin stehen die Pfade der Sandbox, die Regeln für den Zugriff nur von diesem Mac und der Standard-Server, der fremde Hostnamen abweist. Eine Änderung dort wäre beim nächsten Start wieder weg. Deshalb öffnen sich diese Dateien nur lesbar, mit dem Hinweis: „Diese Datei schreibt WebDonkey bei jedem Start neu, deshalb ist sie hier schreibgeschützt.“
Jede Hauptdatei bindet eine Datei ein, die WebDonkey nur einmal anlegt und danach nie mehr anfasst. Der Knopf im Hinweis springt dorthin, zum Beispiel custom.conf öffnen.
| Webserver | Deine Datei | Wo sie wirkt |
|---|---|---|
| nginx | nginx · custom.conf | im Block http { }, gilt für alle Sites |
| Apache | apache · custom.conf | nach den Einstellungen von httpd.conf |
| Caddy | caddy · custom.caddy | auf oberster Ebene des Caddyfile, für Snippets und eigene Site-Blöcke |
Die gemeinsame php.ini
php (alle Versionen) · common.ini gilt für jede installierte PHP-Version zugleich. WebDonkey lädt sie überall, wo es PHP startet: für Webseiten über PHP-FPM, im Terminal und auf der Kommandozeile, in geplanten Aufgaben und für Adminer. Sie wird nach der php.ini der jeweiligen Version geladen, ihre Werte haben deshalb Vorrang. Ein memory_limit = 1024M hier gilt also für PHP 8.3 und 8.4 gleichzeitig, und du musst es nur einmal eintragen.
Beim ersten Start legt WebDonkey die Datei mit einigen auskommentierten Beispielen an (memory_limit, upload_max_filesize, post_max_size, max_execution_time, date.timezone). Klickst du im Quick-Add auf eine dieser Einstellungen, ersetzt WebDonkey die auskommentierte Zeile durch eine aktive.
Was im Hintergrund passiert
- Die Dateien liegen in der Sandbox von WebDonkey, standardmäßig unter
~/Library/Application Support/WebDonkey/config/. Nurpostgresql.confliegt im Datenverzeichnis von PostgreSQL. - Vor dem Speichern sichert WebDonkey die bisherige Fassung in einem eigenen Ordner der Sandbox, nie neben der Datei (siehe Frühere Fassungen und Konflikte).
- Eine
fpm.confprüft WebDonkey vor dem Speichern mit PHP-FPM selbst. Fällt die Prüfung durch, bleibt die alte Datei unverändert. - Einige Zeilen pflegt WebDonkey selbst, deine übrigen Werte bleiben: In die
php.initrägt es einmaligcurl.cainfoundopenssl.cafilefür die lokale Zertifizierungsstelle sowiesendmail_pathfür Mailpit ein, wenn sie fehlen. Inmy.cnfsetzt es bei jedem Start die Pfade zu Datenverzeichnis, Socket, PID- und Log-Datei und ergänzt eine fehlendebind-address. - Eine
fpm.conf, derenlisten =nicht mehr zum Socket passt oder die php.ini-Direktiven wiememory_limitenthält, schreibt WebDonkey beim Start der PHP-Version neu.
Free und Premium
Alle Dateien dieser Liste sind in Free bearbeitbar, außer php (alle Versionen) · common.ini. Sie trägt in Free das Premium-Zeichen, öffnet sich nur lesbar, und Speichern bleibt aus. Die php.ini jeder einzelnen PHP-Version bearbeitest du auch in Free.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Meldung „Diese php-fpm.conf wurde abgelehnt und nicht gespeichert“ mit einem Fehlertext | PHP-FPM hält die Datei für ungültig, PHP würde nicht mehr starten | Behebe die genannte Zeile. Direktiven wie memory_limit gehören in die php.ini, nicht in die fpm.conf. |
| Datei öffnet sich nur lesbar, mit Hinweis auf eine andere Datei | Es ist eine Hauptdatei eines Webservers | Öffne die eigene Datei über den Knopf im Hinweis und trage deine Einstellung dort ein. |
| common.ini lässt sich nicht speichern | Die gemeinsame php.ini ist Premium | Trag den Wert in die php.ini der einzelnen PHP-Version ein oder aktiviere Premium. |
| „Die bisherige Fassung ließ sich nicht sichern, deshalb wurde nicht gespeichert“ | WebDonkey konnte die alte Fassung nicht ablegen, etwa weil der Speicher voll ist | Schaff Platz und speichere noch einmal. Deine Bearbeitung steht weiter im Editor. |
| Dialog Die Datei wurde inzwischen geändert | Die Datei wurde seit dem Laden außerhalb des Editors geändert | Siehe Frühere Fassungen und Konflikte. |
| Die Änderung wirkt nicht | Der Dienst läuft noch mit der alten Konfiguration | Starte den Dienst neu. |
Siehe auch
Systemdateien und eigene Dateien Free
Neben den Dateien deiner Dienste bearbeitest du auf der Seite Konfiguration zwei weitere Arten von Dateien. Systemdateien sind die Konfigurationsdateien deines Benutzerkontos, die du als Entwickler ständig anfasst: .zshrc, ssh/config, .gitconfig, .npmrc und ähnliche. Unter Eigene Konfigurationen trägst du beliebige Textdateien von deinem Mac ein, etwa die .env eines Projekts. Beide öffnen sich im selben Editor, mit Speichern, früheren Fassungen und Konfliktschutz.
So findest du es
Seitenleiste Lokal › Konfiguration, links die Bereiche Eigene Konfigurationen und Systemdateien. Ein Klick auf die Überschrift klappt den Bereich auf.
Systemdateien bearbeiten
- Klapp links Systemdateien auf.
- Wähle eine Datei. Fährst du mit der Maus darüber, zeigt der Tooltip den vollständigen Pfad.
- Ändere den Text und klick Speichern.
Die Liste ist fest vorgegeben und in drei Gruppen sortiert:
| Gruppe | Dateien |
|---|---|
| Shell | .zshrc, .zprofile, .zshenv, .bashrc, .bash_profile, .profile, .aliases, .inputrc |
| SSH & Git | ssh/config, ssh/known_hosts, .gitconfig, .gitignore_global |
| Web-Dev | .npmrc, .yarnrc, composer/config.json, .wgetrc, .curlrc, .editorconfig |
Alle liegen in deinem Home-Ordner, ssh/config also unter ~/.ssh/config und composer/config.json unter ~/.composer/config.json. Gibt es eine Datei noch nicht, trägt sie das Zeichen neu. Speicherst du sie, legt WebDonkey sie an. Eine Änderung an einer Shell-Datei gilt für jedes Terminal, das du danach öffnest.
Andere Dateien lassen sich unter Systemdateien nicht bearbeiten. WebDonkey prüft beim Lesen und Speichern, ob der Pfad wirklich zu einem dieser Einträge gehört, auch über symbolische Links hinweg. Die Datei /etc/hosts steht bewusst nicht in der Liste: Sie gehört dem System, und WebDonkey pflegt die Einträge für deine Sites dort selbst.
Eigene Konfigurationen eintragen
- Klapp links Eigene Konfigurationen auf.
- Klick Hinzufügen. Es öffnet sich die Dateiauswahl von macOS, sie startet in deinem Home-Ordner.
- Wähle die Datei. Sie erscheint in der Liste und öffnet sich sofort im Editor.
Solange die Liste leer ist, steht dort: „Noch keine eigenen Dateien. „Hinzufügen“ trägt eine beliebige Textdatei von deinem Mac ein.“
Die Datei bleibt, wo sie ist. WebDonkey merkt sich nur den Pfad. Folgt der Pfad einem symbolischen Link, löst WebDonkey ihn einmal beim Eintragen auf und bearbeitet danach immer genau die Zieldatei.
Umbenennen und entfernen
Fährst du mit der Maus über einen Eintrag, erscheinen rechts zwei Symbole:
- Stift (Umbenennen (nur in dieser Liste, die Datei behält ihren Namen)): Der Name wird zu einem Eingabefeld. Tippe einen eigenen Namen, höchstens 80 Zeichen, und bestätige mit Enter oder indem du das Feld verlässt. Esc bricht ab. Ein leeres Feld stellt wieder den Dateinamen her. Ein Doppelklick auf den Eintrag startet das Umbenennen ebenfalls.
- × (Aus der Liste entfernen (die Datei selbst bleibt)): WebDonkey fragt Aus der Liste entfernen?. Mit Entfernen verschwindet nur der Eintrag. Die Datei selbst bleibt auf deinem Mac.
Grenzen bei eigenen Dateien
| Was du siehst | Warum |
|---|---|
| „Eintragen lassen sich nur Dateien, keine Ordner.“ | Du hast einen Ordner gewählt. |
| „Diese Datei ist größer als 2 MB.“ | Größere Dateien sind keine Konfiguration, die ein Texteditor laden sollte. |
| „Das ist keine Textdatei (UTF-8).“ | Die Datei ist binär oder nicht in UTF-8 gespeichert. |
| „Diese Datei lässt sich nicht lesen.“ | Dir fehlen die Leserechte. |
| Hinter dem Eintrag steht fehlt, er lässt sich nicht anklicken | Die Datei wurde verschoben oder gelöscht. Entferne den Eintrag und trag die Datei neu ein. |
| „Für diese Datei hast du keine Schreibrechte, sie ist hier nur lesbar.“ | Die Datei gehört einem anderen Benutzer oder ist schreibgeschützt. Du kannst sie lesen, aber nicht speichern. |
Was im Hintergrund passiert
- Die Liste der eigenen Dateien speichert WebDonkey in seiner eigenen Datenbank, nicht neben den Dateien.
- Vor jedem Speichern sichert WebDonkey die bisherige Fassung, wie bei den Service-Konfigurationen (siehe Frühere Fassungen und Konflikte).
- Für System- und eigene Dateien gibt es keinen Quick-Add-Katalog. Der Editor nimmt dann die ganze Breite ein.
Siehe auch
Werte-Katalog Quick-Add Free
Rechts neben dem Editor liegt bei vielen Dateien der Katalog Quick-Add: gängige Einstellungen für genau diese Datei, mit richtiger Schreibweise, einem sinnvollen Wert für die lokale Entwicklung und einer kurzen Beschreibung. Ein Klick fügt die Zeile in deinen Text ein. So musst du nicht nachschlagen, ob es upload_max_filesize oder max_upload_size heißt.
So findest du es
Seitenleiste Lokal › Konfiguration. Wähle unter Service-Konfigurationen eine Datei mit Katalog, zum Beispiel eine php.ini. Rechts erscheint Quick-Add.
So gehst du vor
- Öffne die Datei, zum Beispiel php 8.4.25 · php.ini.
- Tippe in Werte durchsuchen… einen Teil des Namens oder der Beschreibung, etwa
upload. Die Suche achtet nicht auf Groß- und Kleinschreibung. - Klick auf den Eintrag. Die Zeile steht im Editor, der Eintrag bekommt ein Häkchen.
- Pass den Wert im Editor an, wenn du einen anderen willst.
- Klick Speichern und starte den Dienst neu.
Jeder Eintrag zeigt drei Zeilen: den Namen der Einstellung, die Beschreibung (auf Englisch, wie in der Dokumentation des Dienstes) und die fertige Zeile, die eingefügt wird.
Wohin die Zeile kommt
- Steht die Einstellung schon in der Datei, ersetzt WebDonkey diese Zeile, statt eine zweite anzulegen. Das gilt auch für eine auskommentierte Zeile (mit
;oder#davor). So aktivierst du ein Beispiel mit einem Klick. - Steht sie noch nicht drin, hängt WebDonkey sie am Ende an.
- Die Zeile steht erst im Editor. Gespeichert ist sie, wenn du Speichern klickst.
Was drinsteckt
| Datei | Beispiele |
|---|---|
php.ini und common.ini |
memory_limit, upload_max_filesize, post_max_size, max_execution_time, max_input_vars, display_errors, error_reporting, date.timezone, OPcache, Sessions, xdebug.mode, xdebug.start_with_request, xdebug.client_port |
fpm.conf |
pm.max_children, pm.start_servers, pm.max_requests, request_terminate_timeout |
my.cnf (MySQL, MariaDB) |
max_connections, max_allowed_packet, innodb_buffer_pool_size, sql_mode, Slow-Query-Log, Zeichensatz, group_concat_max_len |
postgresql.conf |
max_connections, shared_buffers, work_mem, log_min_duration_statement, timezone |
redis.conf |
maxmemory, maxmemory-policy, appendonly, requirepass |
opensearch.yml, jvm.options |
http.port, discovery.type, -Xms, -Xmx |
config.toml (Meilisearch) |
http_addr, env, master_key, Speicher und Threads beim Indexieren |
minio.env |
MINIO_ROOT_USER, MINIO_ROOT_PASSWORD, MINIO_BROWSER, MINIO_REGION |
memcached.args |
Cache-Größe, Port, Verbindungen, maximale Objektgröße |
| nginx · custom.conf | client_max_body_size, fastcgi_read_timeout, Puffer, Timeouts, gzip |
| apache · custom.conf | Timeout, ProxyTimeout, KeepAlive, LimitRequestBody, ServerName, LogLevel |
Für den Meilisearch-Schlüssel master_key und das MinIO-Passwort schlägt der Katalog einen zufälligen Wert vor, nicht auf jedem Mac denselben.
Keinen Katalog gibt es für mongod.conf (verschachteltes YAML, einzelne Zeilen würden die Datei zerstören), für custom.caddy, für die Hauptdateien der Webserver und für System- und eigene Dateien. Findet die Suche nichts, steht dort Keine passenden Werte.
Siehe auch
Frühere Fassungen und Konflikte Free
Bei jedem Speichern sichert WebDonkey die vorherige Fassung der Datei. Unter Frühere Fassungen vergleichst du sie mit deinem aktuellen Text und holst sie bei Bedarf zurück. Hat jemand die Datei geändert, während du sie im Editor hattest, fragt WebDonkey vor dem Speichern nach, statt die fremde Änderung zu überschreiben. Beides gilt für alle Dateien der Seite: Service-Konfigurationen, Systemdateien und eigene Dateien.
So findest du es
Seitenleiste Lokal › Konfiguration, Datei wählen, dann rechts oben im Editor Frühere Fassungen.
Eine frühere Fassung zurückholen
- Öffne die Datei und klick Frühere Fassungen.
- Links steht die Liste der gesicherten Fassungen mit Datum, Uhrzeit und Größe, die neueste oben. Sie ist schon gewählt.
- Rechts siehst du den Vergleich: links die frühere Fassung, rechts der Text, der gerade im Editor steht. Klick links auf eine andere Fassung, um sie zu vergleichen.
- Klick In den Editor übernehmen. Der Dialog schließt sich, die frühere Fassung steht im Editor.
- Klick Speichern, wenn du sie behalten willst. Erst dann ist sie wieder die Datei auf der Platte.
Gibt es noch keine gesicherte Fassung, steht dort: „Noch keine früheren Fassungen. WebDonkey sichert bei jedem Speichern die vorherige Fassung.“
Was gesichert wird
- WebDonkey behält die letzten 5 Fassungen je Datei. Ältere fallen weg.
- Die Fassungen liegen in einem eigenen Ordner der Sandbox (
config-history), nie neben der Datei. So landet zum Beispiel keine Sicherungskopie einer.envin einem Webordner, aus dem sie abrufbar wäre. - Eine Datei, die es vorher noch nicht gab, hat keine frühere Fassung.
- Lässt sich die bisherige Fassung nicht sichern, speichert WebDonkey auch nicht. Du siehst dann „Die bisherige Fassung ließ sich nicht sichern, deshalb wurde nicht gespeichert“ mit dem Grund. Dein Text bleibt im Editor.
Wenn die Datei inzwischen geändert wurde
WebDonkey merkt sich beim Öffnen, welchen Stand der Datei du vor dir hast. Wurde die Datei seitdem außerhalb des Editors geändert, etwa von einem Installer, einem anderen Programm oder dir im Terminal, erscheint beim Speichern der Dialog Die Datei wurde inzwischen geändert.
- Vergleichen zeigt links die Datei, wie sie jetzt auf deinem Mac liegt, rechts deinen Text.
- Überschreiben speichert deinen Text. Die Fassung, die gerade auf der Platte liegt, sichert WebDonkey vorher, du findest sie unter Frühere Fassungen.
- Neu laden verwirft deine Bearbeitung und lädt die Datei von der Platte in den Editor.
Schließt du den Dialog ohne Wahl, passiert nichts. Dein Text bleibt im Editor und die Datei auf der Platte unverändert.