# Mit der Kommandozeile verwalten Ein paar Betreiberaufgaben leben auf der Kommandozeile statt in der Web-App. Diese Seite listet die Artisan-Befehle auf, die du beim Betrieb einer Instanz tatsächlich brauchen könntest, mit einem Verweis auf die ausführlichere Seite zu jedem davon. Bei einer Docker-Installation führst du jeden Befehl über den Web-Container aus: ``` docker compose exec app php artisan ``` ## Alltäglicher Betrieb ### Instanzadministration gewähren oder entziehen ``` php artisan kollek:make-instance-administrator you@example.com php artisan kollek:make-instance-administrator you@example.com --revoke ``` Gewährt (oder entzieht) das serverweite Administrator-Flag für den Benutzer mit dieser E-Mail-Adresse. So wird der erste Administrator nach der Installation eingerichtet. Siehe [Instanzadministrator-Zugriff gewähren](https://getkollek.com/de/docs/self-hosting-uebersicht/instanzadministrator-zugriff-gewaehren). ### Einen Webhook-Endpunkt erstellen ``` php artisan kollek:create-webhook-endpoint you@example.com https://example.com/hooks --label="My receiver" ``` Registriert einen Webhook-Endpunkt für einen Benutzer und gibt dessen ID und Signaturschlüssel aus. Benutzer können das auch selbst aus ihren Profileinstellungen heraus tun. Beachte, dass momentan noch kein Anwendungsereignis Webhooks auslöst, siehe [Webhooks](https://getkollek.com/de/docs/entwickler/webhooks). ### Den Fotosuche-Index neu aufbauen ``` php artisan photos:rebuild-search-index ``` Baut den Suchindex hinter der Fotobibliothek neu auf und füllt fehlende Bildabmessungen nach. Führe ihn einmal aus, nachdem du auf eine Version aktualisiert hast, die den Fotobildschirm einführt. Er kann jederzeit gefahrlos erneut ausgeführt werden, überspringt Fotos, deren Dateien fehlen, und ändert sonst nichts. Siehe [Deine Instanz aktualisieren](https://getkollek.com/de/docs/self-hosting-uebersicht/instanz-aktualisieren). ### Den Kontosuche-Index neu aufbauen ``` php artisan search:rebuild-index ``` Baut den Index hinter der kontoweiten Suche neu auf, über Objekte, Sammlungen, Exemplare, Fotos, Leihgaben, Standorte, Sets, Reihen, Kategorien, Schlagwörter und Dokumente hinweg. Führe ihn einmal aus, nachdem du auf eine Version aktualisiert hast, die die Suche einführt: Die Migration legt die Tabelle an, gefüllt wird sie aber nur hiervon. Mit `--type=item` baust du nur eine Art von Datensatz neu auf. Er kann jederzeit gefahrlos erneut ausgeführt werden und ist auch die Abhilfe, falls der Index abdriftet. Siehe [Das ganze Konto durchsuchen](https://getkollek.com/de/docs/kernfunktionen/das-ganze-konto-durchsuchen). ### Den Cloudflare-Cache leeren ``` php artisan kollek:purge-cloudflare-cache ``` Verwirft alle öffentlichen Seiten, die Cloudflare vorhält und sonst sieben Tage lang aus seinem Cache ausliefert. Nichts geht verloren: jede Seite wird beim nächsten Besuch neu gerendert. Der Befehl braucht `CLOUDFLARE_API_TOKEN` und `CLOUDFLARE_ZONE_ID` und sagt es, wenn sie fehlen. Denselben Knopf gibt es im Panel, beschrieben in [Das Instanzadministrationspanel](https://getkollek.com/de/docs/self-hosting-uebersicht/instanzadministrationspanel). ### Ein Sprachgebiet für die Übersetzung anlegen ``` php artisan kollek:localize fr_FR ``` Extrahiert jeden übersetzbaren String der Anwendung und gleicht ihn mit der JSON-Datei des Sprachgebiets unter `lang/` ab. Siehe [Eine Sprache hinzufügen](https://getkollek.com/de/docs/self-hosting-uebersicht/eine-sprache-hinzufuegen). ## Nur für die Entwicklung Es gibt zwei weitere Befehle im Code, und keiner davon gehört auf eine Produktivinstanz. `kollek:bruno` setzt die Datenbank mit Seed-Daten für das Testen von API-Clients zurück, was echte Daten zerstören würde, und `kollek:sync-skills` pflegt das eigene Tooling des Projekts. Als Betreiber kannst du beide ignorieren. :::warning Führe `kollek:bruno` niemals auf einer echten Instanz aus. Es löscht die Datenbank vollständig und füllt sie neu mit Demodaten. ::: ## Wie es weitergeht - Richte deinen Administrator ein in [Instanzadministrator-Zugriff gewähren](https://getkollek.com/de/docs/self-hosting-uebersicht/instanzadministrator-zugriff-gewaehren). - Halte die Instanz aktuell mit [Deine Instanz aktualisieren](https://getkollek.com/de/docs/self-hosting-uebersicht/instanz-aktualisieren). - Übersetze die Oberfläche in [Eine Sprache hinzufügen](https://getkollek.com/de/docs/self-hosting-uebersicht/eine-sprache-hinzufuegen).