> ## Documentation Index > Fetch the complete documentation index at: https://docs.vye.lol/llms.txt > Use this file to discover all available pages before exploring further. # Technische Probleme Dieses Dokument dient als detaillierte Referenz für das Support-Team zur Bewältigung technischer Herausforderungen im FiveM-Hosting-Umfeld. Es definiert die Grenzen unserer Dienstleistung und bietet strukturierte Lösungswege für häufig auftretende Probleme. ## 1. Definition der Support-Zuständigkeit Unser Versprechen ist die Bereitstellung einer stabilen, hochperformanten Infrastruktur. Die inhaltliche Gestaltung und Wartung der Server-Software (Scripts, Frameworks, MLOs) obliegt dem Kunden. ### Grundsatz der Nicht-Einmischung * **Kein Script-Debugging:** Als Support-Mitarbeiter untersuchst du keine fehlerhaften Lua-Scripts oder SQL-Fehler innerhalb von Frameworks (ESX, QBCore, vRP). * **Infrastruktur vs. Content:** Wenn die Pterodactyl-Konsole "Running" anzeigt, ist unsere Dienstleistung erbracht. Fehler, die danach in der Konsole erscheinen, sind fast ausnahmslos Konfigurationsfehler des Kunden. ### Ausnahmeregelung Support leistest du nur dann, wenn ein neu installierter Server ohne jegliche Modifikationen des Kunden nicht startet. In diesem Fall liegt ein potenzieller Fehler im "Egg" (Installations-Script) oder dem Host-System vor. ## 2. Pflichtdaten für die Bearbeitung Jedes technische Ticket musst du zwingend mit der Abfrage folgender Daten beginnen, um eine Identifikation im Admin-Bereich zu ermöglichen: 1. **Nutzername im Panel:** Erforderlich für die Suche in der Benutzerdatenbank. 2. **Hinterlegte E-Mail-Adresse:** Abgleich der Inhaberschaft. 3. **Server-UUID (Server-ID):** Zu finden in der URL des Panels oder unter den Server-Einstellungen. Ohne diese Daten darfst du keine Einsicht in die Konsole oder die Log-Dateien nehmen. ## 3. Analyse von Startproblemen und Crash-Loops Wenn ein Server in einer Schleife hängen bleibt (Boot-Loop) oder direkt nach dem Start crasht, gehst du methodisch vor. ### Schritt 1: Konsolen-Log auswerten Fordere den Kunden auf, den relevanten Teil der Konsole als Text oder Screenshot zu senden. Achte auf folgende Schlüsselbegriffe: * `Authenticated mit Cfx.re failed`: Meist ein ungültiger oder fehlender License Key. * `Could not bind to port`: Ein Port-Konflikt (sofort an die Administration melden). * `Script Error`: Ein Fehler in einer Datei des Kunden. ### Schritt 2: Basis-Check der Startparameter Prüfe im Reiter "Startup" des Pterodactyl-Panels: * Ist ein gültiger **Cfx.re License Key** eingetragen? * Sind die Pfadangaben zur `server.cfg` korrekt? * Entspricht die **Server-Version (Artifacts)** den Anforderungen der installierten Scripte? ### Schritt 3: Empfehlung bei Script-Fehlern Wenn der Fehler eindeutig von einem Script verursacht wird, schließt du das Ticket mit folgendem Hinweis: > "Dein Server weist einen Fehler in der Datei > > \$\$Dateiname\$\$ > > auf. Da dies ein inhaltlicher Fehler deiner Konfiguration ist, können wir hier keinen direkten Support leisten. Bitte nutze das offizielle Cfx.re Forum oder unser Community-Support-Forum unter \<#1496741592319529051> für Hilfestellungen durch andere Nutzer." ## 4. Datenbankverwaltung (Internal Only) Da unsere Datenbank-Infrastruktur aus Sicherheitsgründen intern verwaltet wird, ergeben sich oft Fragen zum Import von Daten. * **Automatisierung:** Pterodactyl erstellt beim Anlegen einer Datenbank automatisch die Zugangsdaten. Diese sind für die `server.cfg` des Kunden bestimmt. * **phpMyAdmin:** Für manuelle Eingriffe (Import von `.sql` Dateien, Bearbeiten von User-Tabellen) stellen wir einen Zugang bereit. Dieser ist für den Kunden direkt über das Dashboard einsehbar. * **Vorgehensweise bei Fehlern:** Sollte die Verbindung zur Datenbank fehlschlagen ("Connection Refused"), prüfe im Admin-Panel, ob der Datenbank-Container läuft. Falls ja, liegt der Fehler meist an falschen Zugangsdaten in der `server.cfg` des Kunden. ## 5. Datei-Management und SFTP-Richtlinien Der Web-Dateimanager von Pterodactyl ist für kleinere Änderungen an Konfigurationsdateien gedacht, nicht für den Massenupload von Ressourcen. ### Upload-Beschränkungen * **Limit:** Der Web-Manager hat ein hartes Limit von **2 GB pro Datei**. * **Problematik:** Bei großen Uploads über den Browser kommt es häufig zu Timeouts oder korrupten Dateien. ### Support-Empfehlung Weise Kunden bei größeren Projekten (MLOs, Fahrzeug-Packs, komplette Frameworks) ausdrücklich auf die Nutzung von **WinSCP** hin. * Die Zugangsdaten finden Kunden im Panel unter "Settings" -> "SFTP Details". * **Tipp für Kunden:** Große Ordner sollten lokal als `.zip` gepackt, hochgeladen und dann über die "Unarchive"-Funktion im Panel entpackt werden. Dies ist die schnellste und sicherste Methode. ## 6. Performance-Analyse und Lags Wenn Kunden über Lags klagen, kommuniziere professionell, dass unsere Host-Systeme bereits auf maximalem Niveau arbeiten. ### Unsere Host-Konfiguration (Fakten für den Support) Um Lags serverseitig auszuschließen, sind alle Nodes wie folgt konfiguriert: 1. **Windows Defender Deaktivierung:** Das Laufwerk ist von Echtzeit-Scans ausgeschlossen, um E/A-Verzögerungen zu verhindern. 2. **Prozess-Priorität:** Alle Server-Instanzen laufen mit der Priorität "High". 3. **Geschwindigkeits-Limit:** Die Geschwindigkeit ist fest auf 33 limitiert, um konstante Rechenzyklen ohne Spikes zu garantieren. ### Fehleranalyse beim Kunden Performance-Einbrüche sind zu 99% "Script-Lags" oder "Network-Sync-Issues". * **Resmon-Check:** Fordere den Kunden auf, Ingame `/resmon 1` in die Konsole einzugeben. Alles über 5ms (CPU-Zeit) bei einem einzelnen Script ist kritisch. * **Mismatched Artifacts:** Veraltete Server-Builds können Desyncs verursachen. Empfehle ein Update auf die neueste "Recommended" Version. * **Mahnung zur Optimierung:** Erkläre freundlich, dass Hardware-Lags bei unserer Konfiguration technisch nahezu ausgeschlossen sind und der Kunde seine Ressourcen selbst optimieren muss. ## 7. Eskalationsmanagement Sollten alle oben genannten Schritte nicht zur Lösung führen und der Verdacht auf ein Problem mit dem Node (Host-System) bestehen, eskaliere das Ticket. **Eskalationsgründe:** * Mehrere Kunden auf demselben Node melden zeitgleich Probleme. * Der Server lässt sich im Panel nicht mehr stoppen oder killen. * Fehlermeldungen deuten auf volle Festplatten oder defekten RAM hin (z.B. "No space left on device"). **Ansprechpartner:** * Kontaktiere **Dustin** oder **Jannik** direkt und sende die Ticket-ID sowie deine bisherigen Analyseergebnisse mit.