Zum Inhalt springen
Octibiz
Demo

Durchsucht Website und Dokumentation gemeinsam. Enter zeigt alle Treffer, Esc schließt.

Technische Voraussetzungen

Was dein Server mitbringen muss.

Harte Zahlen statt Ungefähr-Angaben: Diese Liste ist gegen die Prüfung im Installer abgeglichen, nicht gegen ein Datenblatt. Wer sie vorher abhakt, ist in einer halben Stunde online.

PHP 8.4+ MariaDB 10.11+ oder MySQL 8.0+ Installation ohne SSH möglich

Die vier Eckwerte

PHP

8.4 oder neuer

Dazu neun Pflicht-Erweiterungen. Drei weitere sind empfohlen: curl, gd und zip.

Datenbank

MariaDB 10.11+ oder MySQL 8.0+

Freigegeben sind MariaDB 10.11, 11.4 und 11.8 sowie MySQL 8.0 und 8.4. PostgreSQL wird nicht unterstützt.

Webserver

nginx oder Apache

Document-Root auf public/. Vorlagen für beide liegen im Paket. HTTPS ist Pflicht, die Anmeldung arbeitet mit sicheren Cookies.

Hintergrund-Verarbeitung

Cron oder systemd

Ohne laufende Worker verschickt das System keine Mail und führt keinen Termin aus.

Die neun PHP-Erweiterungen

Alle neun werden vom Installer geprüft und blockieren die Einrichtung, wenn sie fehlen. Ein Befehl beantwortet die Frage:

php -m | grep -xE 'ctype|iconv|json|sodium|pdo_mysql|openssl|mbstring|redis|intl' | sort | tr '\n' ' '

Die Ausgabe muss neun Namen enthalten. Kommen weniger, fehlt die Differenz.

Pflicht-Erweiterungen für PHP
Erweiterung Wofür
ctype Zeichentyp-Funktionen
iconv Zeichensatz-Umwandlung
json JSON
sodium Verschlüsselung der Zugangsdaten zu angebundenen Systemen
pdo_mysql Datenbanktreiber
openssl JWT-Schlüssel und Verschlüsselung
mbstring Mehrbyte-Zeichenketten
redis Zwischenspeicher und Warteschlangen im Echtbetrieb
intl Datums-, Zeit- und Zahlenformate je Sprache

Zwei Stolpersteine, die wir offen benennen. Das Vorbereitungs-Skript prüft redis und intl derzeit nicht mit. Es läuft grün durch, der Assistent blockt danach rot. Und Chromium wird überhaupt nicht geprüft, obwohl ohne es keine Beleg-PDF entsteht. Beides prüfst du besser selbst, bevor du anfängst.

So läuft die Installation

Eine einzige Datei per FTP hochladen, im Browser öffnen, fertig. Kein SSH, keine Kommandozeile, kein Docker. Die Datei prüft den Server, lädt Octibiz selbst herunter, kontrolliert die Prüfsumme, entpackt und übergibt an den Assistenten. Danach löscht sie sich.

Der ganze Ablauf

install.php hochladen → im Browser öffnen → fünf Fragen beantworten → anmelden

Wer lieber selbst entpackt, nimmt das Paket und ./setup.sh über SSH. Beide Wege enden im selben Assistenten.

Die hochgeladene install.php im Browser: sie prüft PHP-Version, Erweiterungen, Netzverbindung und Schreibrechte, alle mit grünem Haken
Die hochgeladene Datei im Browser. Sie prüft den Server und nennt jede fehlende Voraussetzung einzeln, statt allgemein zu scheitern.
Der Installer lädt das Octibiz-Paket herunter, mit Fortschrittsbalken und abgehakten Schritten
Rund 90 MB, in Häppchen geladen. Bricht die Verbindung ab, setzt der nächste Versuch dort fort, statt von vorne zu beginnen.
Schritt 1 des Octibiz-Assistenten: die Systemprüfung listet PHP-Version und jede geprüfte Erweiterung einzeln mit grünem Haken auf
Danach übernimmt der Assistent. Schritt 1 prüft noch einmal gründlicher, was die Anwendung selbst braucht.
Schritt 2 des Octibiz-Installers: Eingabefelder für öffentliche Adresse, Datenbank-Host, Port, Name, Benutzer und Passwort
Schritt 2 testet den Datenbank-Zugang sofort. Erst wenn die Verbindung steht, geht es weiter.
Abschluss des Octibiz-Installers: alle neun Einrichtungsschritte mit grünem Haken und der Hinweis, das Installationsverzeichnis zu entfernen
Am Ende stehen Schema, Rechte, Stammdaten und dein Administrator-Konto. Der Assistent sperrt sich danach selbst.

Jeder Schritt einzeln erklärt, mit allen Feldern, allen Fehlermeldungen und dem, was nach der Installation noch zu tun ist: die vollständige Installationsanleitung.

Was nach der Installation noch dazugehört

Der Assistent richtet die Anwendung ein, nicht den Betrieb. Vier Dinge fehlen danach noch, und ohne sie ist das System zwar installiert, aber nicht betriebsbereit.

  • Installationsverzeichnis entfernen. Es sperrt sich selbst, aber weg ist sicherer.
  • Hintergrund-Worker einrichten. Ohne sie geht keine Mail raus und läuft kein Termin. Der Zeitplan-Dienst darf dabei genau einmal laufen, sonst feuern wiederkehrende Rechnungen und Mahnläufe doppelt.
  • Sicherung einrichten und die Datei mit den Geheimnissen ins Backup aufnehmen. Geht der Schlüssel für die Zugangsdaten verloren, sind alle gespeicherten Anbindungen dauerhaft unlesbar.
  • Mail-Zustellbarkeit klären, also SPF, DKIM und DMARC je Absender-Domain.

Wenn du das nicht selbst machen willst: Im Setup-Paket übernehmen wir Installation, Härtung und Abnahme auf deiner Infrastruktur. Details auf der Self-Hosted-Seite.

Häufige Fragen zu den Voraussetzungen

Brauche ich Composer oder Node auf dem Server?

Für den normalen Weg nicht. Octibiz kommt als vorgebautes Paket, in dem die PHP-Bibliotheken und die fertige Oberfläche bereits enthalten sind. Node wird erst nötig, wenn du später ein Plugin installierst, das die Oberfläche neu bauen lässt. Wer stattdessen aus dem Quellcode ausrollt, braucht beides.

Mehr dazu lesen
Läuft das auf einem normalen Webhosting-Paket?

Ja, wenn der Anbieter PHP 8.4 mit den neun Erweiterungen anbietet, proc_open nicht sperrt und Cron-Aufrufe erlaubt. Der Installer läuft dann über den Browser statt über SSH. Die beiden häufigsten Hürden sind eine gesperrte proc_open-Funktion und ein fehlendes Chromium für Beleg-PDFs. Beides solltest du vorher beim Anbieter erfragen.

Mehr dazu lesen
Wie viel RAM und Plattenplatz braucht das?

Dafür haben wir keine belastbare Zahl, und wir nennen hier keine, die wir nicht belegen können. Als Anhaltspunkt: Jeder Hintergrund-Worker läuft mit einer Grenze von 256 MB, voreingestellt sind zwei. Beim Aktualisieren liegt die Oberfläche kurzzeitig doppelt auf der Platte. Für eine konkrete Dimensionierung sprich uns an, dann rechnen wir das an deiner Nutzerzahl und deinem Belegvolumen durch.

Warum ist Chromium Pflicht?

Weil die Beleg-Erzeugung darüber läuft. Ohne Chromium im Suchpfad entsteht keine Rechnung als PDF. Das ist die Kern-Engine und kein Nebenweg. Ärgerlich daran: Der Installer prüft es nicht mit, es fällt also erst im Betrieb auf. Deshalb steht es hier so deutlich.

Mehr dazu lesen
Wie lange dauert die Installation?

Zwanzig bis dreißig Minuten, wenn der Server die Voraussetzungen erfüllt. Der Assistent selbst braucht meist unter einer Minute, der Download davor ein bis drei. Was danach kommt, also Hintergrund-Worker, Sicherung und Mail-Zustellbarkeit, kostet mehr Zeit als die Installation.

Mehr dazu lesen
Ich habe nur FTP, keinen SSH-Zugang. Geht das trotzdem?

Ja. Du lädst eine einzige Datei hoch und rufst sie im Browser auf, alles Weitere passiert per Klick. Die Datei holt sich Octibiz selbst vom Update-Server, prüft die Prüfsumme, entpackt und übergibt an den Assistenten. Du siehst dabei keine Kommandozeile und musst auch keinen Zugangsschlüssel irgendwo auslesen. Nötig ist nur, dass dein Server ins Internet darf und PHP 8.4 anbietet.

Mehr dazu lesen

Unsicher, ob dein Server passt?

Schick uns die PHP-Info und den Hoster, dann sagen wir dir vor dem Kauf, ob es läuft und was gegebenenfalls fehlt.