yesPlatt Installation

Einfache und zuverlässige Installation für yesPlatt und zugehörige Anwendungen und Erweiterungen.

📖 Das yesPlatt-Universum

yesPlatt ist eine Plattform, die aus der Hauptanwendung besteht, welche durch Plugins erweitert werden kann.
Die Hauptanwendung stellt die grundlegende Anwendungsoberfläche zur Verfügung. Außerdem ist da schon die Nutzer-, Rechte- und Mandantenverwaltung implementiert.
Im Hintergrund stellt die Hauptanwendung Klassen und Resourcen zur Darstellung von Eingabemasken und Tabellen usw. für die Plugins zur Verfügung.
Plugins unterteilen sich fachlich in Anwendungsplugins wie z.b. miaonline und Erweiterungsplugins wie z.b. totp oder lox24.
Während der Installation werden alle Plugins zur Auswahl angeboten, die durch das übergebenen Gitlab-Token freigeben werden.
Zugangsdaten für Gitlab bekommen Sie beim Autor auf Anfrage.

🚀 Installation

Das Skript benötigt Root-Rechte. Führe es mit folgendem Befehl in dem Ordner für die Installation aus:

wget -qO- https://install.yesplatt.de/yesinstall.sh | sudo bash

Oder alternativ mit curl:

curl -s https://install.yesplatt.de/yesinstall.sh | sudo bash

Das Skript lädt sich direkt aus dem Repository herunter und führt die Installation durch.

Wichtig: Bitte das Skript per Pipe (| sudo bash) ausführen, nicht per Process-Substitution (sudo bash <(wget/curl ...)). Unter sudo wird dabei aus Sicherheitsgründen der von der Process-Substitution verwendete Datei-Deskriptor geschlossen, bevor bash das Skript einlesen kann - das Skript bricht dann sofort mit bash: /dev/fd/N: Bad file descriptor ab, ohne dass überhaupt eine Zeile davon ausgeführt wurde. Die Pipe-Variante oben ist davon nicht betroffen.

⚠️ Sicherheit

• Das Skript wird direkt von hier geladen und ausgeführt
• Wenn du unsicher bist, kannst du das Skript auch lokal herunterladen und inspizieren:

wget https://install.yesplatt.de/yesinstall.sh
cat yesinstall.sh  # Überprüfe den Inhalt
sudo bash yesinstall.sh

📋 Voraussetzungen

• Root-Rechte (das Skript prüft dies selbst und bricht sonst sofort ab)
• Bash 4.0 oder höher
• wget oder curl (zum Herunterladen des Skripts)
• Weitere nötige Anwendungen auf der Shell git, curl, getent (nicht unter macOS), mysql, dialog, jq, php
• Für die Anwendung selbst wird folgendes benötigt:
  • Apache 2.4 mit den Modulen mod_reqrite und mod_header
  • PHP mind. Version 8.3 mit den Modulen bcmath,Core,ctype,curl,date,dom,fileinfo,filter,gd, hash,iconv,json,libxml,mbstring,mysqli,mysqlnd,openssl, pcre,random,Reflection,session,SimpleXML,SPL,sqlite3, standard,tokenizer,xml,xmlreader,xmlwriter,zip,zlib
  • MySQL oder MariaDB vorzugsweise neueste Versionen

🔧 Was das Skript installiert

Das Script installiert die Hauptanwendung (yesPlatt) und ausgewählte Anwendungs- und Erweiterungsplugins.

📖 Verwendung nach Installation

Nach der Installation muss noch ein Apache-vHost siehe example.vhost.conf für die entsprechende Domain.

🐛 Troubleshooting

“Command not found: wget/curl”

Installiere wget oder curl:

# Debian/Ubuntu
sudo apt-get install wget curl

# macOS (mit Homebrew)
brew install wget curl

# Red Hat/CentOS
sudo yum install wget curl

Berechtigungsfehler

Das Skript benötigt zwingend Root-Rechte und bricht ohne diese sofort mit einer entsprechenden Meldung ab:

wget -qO- https://install.yesplatt.de/yesinstall.sh | sudo bash

“bash: /dev/fd/N: Bad file descriptor” unter sudo

Das Skript wurde per Process-Substitution aufgerufen (sudo bash <(wget/curl ...)). sudo schließt dabei den dafür verwendeten Datei-Deskriptor, bevor bash das Skript einlesen kann. Stattdessen die Pipe-Variante verwenden (siehe oben: ... | sudo bash).

“Dieses Skript benötigt Bash 4 oder neuer” trotz installierter aktueller Bash

Unter sudo wird der Befehl bash je nach $PATH manchmal auf eine ältere Systemversion aufgelöst - z. B. liefert macOS auch mit installierter Homebrew-Bash über sudo bash --version oft weiterhin die mitgelieferte Bash 3.2. Prüfen mit sudo bash --version und im Zweifel die gewünschte Bash mit vollem Pfad aufrufen, z. B.:

sudo /opt/homebrew/bin/bash yesinstall.sh

Hinweis: Dieses Skript wird regelmäßig gewartet und aktualisiert. Stelle sicher, dass du die aktuelle Version verwendest.