Ticketix wird aus dem Installations-ZIP-Paket in einen neuen, leeren Ordner installiert. Eine browserbasierte Einrichtung erstellt die Konfiguration und das erste Administratorkonto.
Bevor Sie beginnen
- Prüfen Sie die Serveranforderungen.
- Halten Sie das Ticketix-Installations-ZIP auf Ihrem Computer bereit. Laden Sie es über den Link in Ihrer Lizenz-E-Mail herunter. Verwenden Sie für eine Neuinstallation nicht das Update-ZIP und laden Sie das Installationspaket nicht über eine bestehende Installation hoch.
- Erstellen Sie eine leere MySQL-Datenbank (
utf8mb4) und einen Datenbankbenutzer mit vollen Rechten darauf. - Legen Sie die öffentliche Adresse fest, zum Beispiel
https://support.example.comoderhttps://support.example.com/ticketix, und stellen Sie sicher, dass sie über HTTPS funktioniert. - Installieren Sie eine Authenticator-App auf Ihrem Smartphone. Sie benötigen sie bei der ersten Anmeldung.
Die Dateien hochladen
- Entpacken Sie das Installations-ZIP in den Webordner der gewählten Adresse.
- Stellen Sie sicher, dass der Webserver-Benutzer in den Anwendungsordner und in den Ordner
storageschreiben kann. - Fügen Sie unter Nginx die in den Voraussetzungen beschriebenen Zugriffsregeln hinzu. Unter Apache erledigt dies die mitgelieferte Datei
.htaccess.
Das Setup ausführen
- Öffnen Sie die Einrichtungsseite unter der öffentlichen Adresse, zum Beispiel
https://support.example.com/setup.php. Öffnen Sie sie unter der endgültigen Adresse: Die Einrichtung speichert diese Adresse alsapp_url. - Füllen Sie die Felder aus:
| Feld | Was Sie eingeben |
|---|---|
| App-Name | Der Name, der in der Oberfläche und in E-Mails angezeigt wird |
| Standardsprache | English, Türkçe oder العربية |
| Speicherstamm | Der Speicherordner; behalten Sie den vorgeschlagenen Ordner storage bei, sofern Ihr Hoster keinen anderen Pfad benötigt |
| Support-E-Mail | Die Adresse, die Kunden sehen, und der Standardabsender |
| Mailserver-Host | Der Hostname Ihres Mailservers |
| Host, Port, Datenbankname, Datenbankbenutzer, Datenbankpasswort | Ihre MySQL-Zugangsdaten, unter Datenbank (MySQL) |
| Zeichensatz, Kollation | Behalten Sie utf8mb4 und utf8mb4_unicode_ci bei, sofern Sie keinen Grund für eine Änderung haben |
| Admin-Name, Admin-E-Mail, Administratorpasswort | Das erste Administratorkonto; das Passwort muss mindestens 8 Zeichen lang sein |
- Klicken Sie auf Ticketix installieren. Die Einrichtung testet die Datenbankverbindung, schreibt
config.phpund legt die Tabellen sowie das Administratorkonto an. - Wenn Installation abgeschlossen. Sie können sich jetzt anmelden. angezeigt wird, klicken Sie auf Admin-Anmeldung.
Sobald Ticketix installiert ist, führt setup.php nur noch zur Anmeldeseite. Der Einrichtungsbildschirm empfiehlt, setup.php nach der Installation zu entfernen. Ab Ticketix 2.0.2 enthält das Update-ZIP keine setup.php, sodass eine entfernte setup.php durch ein Update nicht wiederhergestellt wird.
Die Datei config.php und app_url
Die Einrichtung erstellt die dauerhafte config.php aus der Vorlage config.sample.php. Sie enthält die Datenbankdaten, die von Ticketix erzeugten Geheimschlüssel (für die geplante Aufgabe, die Zustandsprüfung und eingehende E-Mails) sowie diese Einstellungen:
| Einstellung | Standard | Funktion |
|---|---|---|
app_url | Die Adresse, unter der Sie die Einrichtung geöffnet haben | Die öffentliche Adresse für Links in E-Mails, auch in E-Mails, die die geplante Aufgabe versendet |
storage_root | Der Ordner storage | Anhänge, Protokolle, Sitzungen, die Lizenzdateien und ai-secret.key |
auto_close_days | 7 | Tage, nach denen Tickets im Status Ausstehend oder Beantwortet automatisch geschlossen werden |
invite_expiry_hours | 72 | Wie lange ein Einladungslink für Kunden gültig bleibt |
app_url ist die vollständige öffentliche Adresse einschließlich eines eventuellen Unterordners, ohne abschließenden Schrägstrich:
'app_url' => 'https://support.example.com/ticketix',
Wenn Sie Ticketix später an eine andere Adresse verschieben, ändern Sie app_url in config.php. Ohne korrekte app_url lassen sich Links in E-Mails der geplanten Aufgabe (zum Beispiel die Bestätigung eines aus eingehender E-Mail erstellten Tickets) nicht öffnen.
Wichtig: Veröffentlichen Sie
config.phpniemals und ersetzen Sie sie nie bei Updates. Sichern Sie sie zusammen mit dem Ordnerstorage.
Erste Anmeldung
Administratoren und Agenten müssen die Zwei-Faktor-Authentifizierung verwenden. Sie richten sie bei Ihrer ersten Anmeldung ein:
- Öffnen Sie die Mitarbeiter-Anmeldeseite unter
/admin/(zum Beispielhttps://support.example.com/admin/). Die Seite heißt Mitarbeiter-Anmeldung. - Geben Sie die Administrator-E-Mail unter E-Mail oder Anzeigename und das Passwort ein und klicken Sie auf Anmelden.
- Ticketix öffnet Zwei-Faktor-Authentifizierung einrichten. Öffnen Sie Ihre Authenticator-App, fügen Sie ein Konto hinzu und scannen Sie den QR-Code. Falls das Scannen nicht möglich ist, öffnen Sie Scannen nicht möglich? Einrichtungsschlüssel eingeben und geben Sie den Schlüssel in der App ein.
- Geben Sie den Sechsstelligen Code aus der App und Ihr Aktuelles Passwort ein und klicken Sie dann auf Zwei-Faktor-Authentifizierung aktivieren.
- Ticketix zeigt Backup-Codes speichern an: zehn Einmalcodes. Bewahren Sie sie in Ihrem Passwort-Manager auf. Sie werden nur einmal angezeigt.
Der Einrichtungscode ist zehn Minuten gültig. Wenn er abläuft, klicken Sie auf Neuen Einrichtungscode erstellen und scannen Sie den neuen QR-Code.
Ab jetzt fragt jede Anmeldung nach dem Passwort einen Code aus Ihrer Authenticator-App ab. Siehe Zwei-Faktor-Authentifizierung und Zurücksetzen des Passworts.
Nach der Installation
- Beschränken Sie den Schreibzugriff auf den Anwendungsordner auf den Benutzer, unter dem PHP läuft. Updates über den Bildschirm Neuigkeiten erfordern, dass PHP die Anwendungsdateien schreiben kann; ist das nicht möglich, aktualisieren Sie manuell mit dem Update-ZIP. Der Ordner
storagemuss beschreibbar bleiben. Siehe Ticketix aktualisieren. - Sichern Sie
config.phpund den Ordnerstorageregelmäßig an einem Ort mit eingeschränktem Zugriff.storage/ai-secret.keyschützt gespeicherte Schlüssel von KI-Anbietern und die Authenticator-Geheimnisse der Zwei-Faktor-Authentifizierung.