Zum Inhalt springen
CitexNodeAnleitungen
Alle Anleitungen

Datenbanken, Dateien und Speicher

MySQL-Datenbanken anlegen, Zugangsdaten als Variablen und Platzhalter, Konfigurationsdateien und dauerhafte Ordner für Uploads.

2 Min. LesezeitAktualisiert am 17.10.2026

Datenbanken

Unter Deploy → Datenbanken legst du eine MariaDB-Datenbank an, kompatibel zu MySQL. Sie läuft auf drei Servern gleichzeitig, fällt einer aus, arbeiten die anderen weiter. Wie viele Datenbanken du haben kannst, hängt vom Plan ab.

Ordnest du eine Datenbank einem Projekt zu, bekommt es die Zugangsdaten als Variablen:

VariableInhalt
DB_HOSTmysql
DB_PORT3306
DB_NAME, DB_USER, DB_PASSWORDdie Zugangsdaten
DATABASE_URLalles in einer Zeile, mysql://…

Das gilt für die erste zugeordnete Datenbank. Jede weitere ist zusätzlich unter ihrem Namen erreichbar, etwa DB_SHOP_HOST, DB_SHOP_NAME. Eine eigene Variable mit demselben Namen hat Vorrang.

Erreichbar ist die Datenbank nur aus deinen Projekten, nicht aus dem Internet. Löschst du ein Projekt, bleibt die Datenbank erhalten. Sie zu löschen ist ein eigener Schritt mit Bestätigung.

Konfigurationsdateien

Unter Konfigurationsdateien legst du Dateien an, die beim Start in der App liegen, ohne im Repository zu stehen: höchstens 20 je Projekt, je bis 64 KB, nur lesbar. Der Pfad zählt ab dem Projektordner, etwa config/database.local.php.

Im Inhalt setzt du Platzhalter, wir füllen sie beim Deploy:

php
<?php
return [
    'host' => '${DB_HOST}',
    'name' => '${DB_NAME}',
    'user' => '${DB_USER}',
    'pass' => '${DB_PASSWORD}',
    'key'  => '${env:APP_KEY}',
];

${env:NAME} liest eine deiner Variablen.

Dauerhafter Speicher

Alles, was die App zur Laufzeit schreibt, ist beim nächsten Deploy weg. Das ist Absicht, jede Fassung startet sauber. Für Uploads, Caches, die bleiben sollen, oder SQLite-Dateien legst du unter Dauerhafter Speicher einen Ordner an, etwa uploads. Er überlebt jeden Deploy und liegt auf allen Servern.

Beim ersten Anlegen kopieren wir, was im Repository schon in dem Ordner liegt, einmalig hinein. Die Belegung messen wir stündlich, die Grenze hängt vom Plan ab.