Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- open:it:nextcloud [2024/06/14 18:46] – k@i
+++ open:it:nextcloud [2026/06/27 14:13] (aktuell) – k@i
@@ Zeile 1: / Zeile 1: @@
 ====== Nextcloud ======
-Nextcloud ist eine sehr komplexe Anwendung und, damit es rund läuft, erfordert viele Einstellungen am System. System und Einstellungen müssen außerdem dauerhaft überwacht werden. \\
+++++ Quellen |
-In Bezug auf die Dateiverwaltung und das integrierte Office-System ist es ein gutes System. \\
+https://docs.nextcloud.com/server/latest/admin_manual/installation/source_installation.html \\
-Bei Kontakten, Kalendern (inkl. Einladungen) und Aufgaben halte ich das System [[open:it:radicale|Radicale]] für deutlich besser. Einmal sauber installiert läuft es sehr stabil und der Datenzugriff war bei meinen Installationen deutlich schneller als bei Nextcloud. \\
-(Beim Aufruf der) E-Mail-App von Nextcloud hat das System etliche der IMAP-E-Mails selbstständig mit Schlagwörtern markiert (z.B. "Wichtig") - Stand ~05/2023. Das musste ich dann mühsam und manuell über ein anderes E-Mailprogramm rückgängig machen. Daher nutze ich auch die App für die E-Mails nicht mehr. \\
-===== Allgemeine Informationen =====
 https://docs.nextcloud.com/server/latest/admin_manual/ \\
 https://arnowelzel.de/client-push-fuer-nextcloud-einrichten \\
+++++
 ===== Installation =====
 Installation auf eigenem Server.\\
 Minimal-Variante: Daten, Kalender, Kontakte.
+  * Datenbank anlegen (z.B. MariaDB) - Zugangsdaten bereithalten (Host, DB-Name, DB-User, Passwort)
   * Installationsdatei [[https://download.nextcloud.com/server/installer/setup-nextcloud.php|downloaden]]
   * Per SFTP auf Server übertragen (Ordner www-Seiten Nextcloud)
-  * Datenbank einrichten (z.B. MariaDB) - Zugangsdaten bereithalten (Host, DB-Name, DB-User, Passwort)
   * Im Browser: Domain gefolgt von **/setup-nextcloud.php** aufrufen (PHP muss installiert sein).
-  * Apps -> nicht die bei der Installation angebotenen Standard-Apps (dort abbrechen)
+  * System schlank halten: nicht die bei der Installation angebotenen Standard-Apps (dort abbrechen)
-  * Apps manuell zur Installation auswählen
+  * gewünschte Apps manuell zur Installation auswählen, z.B.
     * Contacts
     * Calendar
@@ Zeile 25: / Zeile 20: @@
   * Sprache der einzelnen User (nur für Web-Oberfläche interessant / jeweils einloggen)
+zusätzliche PHP-Module installieren (je nach Bedarf und Version)
+  sudo apt install php8.2-gmp php8.2-bcmath php8.2-imagick php8.2-intl php8.2-apcu
+==== Hintergrundaufgaben ====
+**Über Cronjob nur realisierbar, wenn Zugriff über die Konsole besteht!** \\
+Frontend: Administratoreinstellungen -> Grundeinstellungen -> Cron (Empfohlen) auswählen \\
+Auf dem Server automatisieren:
   sudo nano /etc/crontab
-  */5 * * * *     www-data php -f /var/www/bluegnu.de_cloud/cron.php
+  */5 * * * *     www-data php -f /var/www/nextcloud/cron.php
 Pfad anpassen!!
-Hintergrundaufgaben über Cronjob einrichten \\
+==== Konfiguration ====
-Administratoreinstellungen -> Grundeinstellungen -> Cron )Empfohlen) auswählen \\
-=== Datenpfad ändern ===
   sudo nano config/config.php
+Datenpfad.
+  'datadirectory' => '/var/www/data/bluegnu.de',
+Sicherheit: Hier liegt der Pfad außerhalb des Webseitenbereichs, wodurch dieser nur über Serverscripte oder SSH-Zugriffe erreichbar ist. I.d.R. wird dies bei der Installation festgelegt und damit die Struktur angelegt. Wird der Pfad später manuell geändert, empfiehlt es sich, die Daten aus dem ursprünglichen Pfad dorthin zu kopieren bzw. zu verschieben. \\
+Region
+  'default_phone_region' => 'DE',
+Zeitfenster für Hintergrund-Wartungen begrenzen (ab Uhrzeit max 4 h)
+  'maintenance_window_start' => 3,
-  'datadirectory' => '/var/www/data/bluegnu.de_cloud',
+==== Apps ====
+Installation über die Webseite der installierten Cloud -> Apps. \\
+  * [[https://apps.nextcloud.com/apps/calendar|Kalender]]
+  * [[https://apps.nextcloud.com/apps/contacts|Kontakte, Adressen]]
+  * [[https://apps.nextcloud.com/apps/mail|Mail]]
+  * [[https://apps.nextcloud.com/apps/spreed|Talk]]
+  * [[https://apps.nextcloud.com/apps/tasks|Tasks]]
+  * [[https://apps.nextcloud.com/apps/richdocuments|Nextcloud Office]]
+  * [[https://github.com/nextcloud/circles|Teams]]
+  * [[https://apps.nextcloud.com/apps/groupfolders|Team-Ordner]]
+  * [[https://apps.nextcloud.com/apps/files_3dmodelviewer|3D Model Viewer]]
+  * [[https://github.com/nextcloud/files_pdfviewer|PDF-Viewer]]
+  * [[https://github.com/nextcloud/photos|Fotos]]
+  * [[#Ressourcen anlegen|Calendar Ressource Management]]
-Zeile so komplett einfügen oder korrigieren. Pfadangabe absolut. \\
+==== Optimierungen ====
-Sicherheit: Am besten den Pfad außerhalb des Pfades der Webseite wählen, dann ist dieser nur über Serverscripte erreichbar. \\
+Abarbeitung entsprechend Infos auf Nextcloud-Adminseite. \\
+Es müssen ggf. PHP- und/oder Apache-Module nachinstalliert werden oder Anpassungen in der PHP.INI erfolgen - die für die Seite zuständige. Welche genutzt wird, hängt von den Einstellungen im Webserver ab. \\
+Bei Apache und der in diesem System genutzten Variante mit **fpm**, siehe [[open:it:apache#php|Apache Web-Server]], befindet sie sich - für die Version 8.2 - hier:
-===== Update-Probleme =====
+  sudo nano /etc/php/8.2/fpm/php.ini
+zum Beispiel memory_limit erhöhen
+  memory_limit = 512M
+Datenbank-Indexe aufräumen - als root auf Konsole ausführen - im Verzeichnis der Webseite
+  sudo -u www-data php occ db:add-missing-indices
+Anpassungen in der Domain-Config (in der Version für Lets-Encrypt)
+  sudo nano /etc/apache2/sites-available/bluegnu.de_cloud-le-ssl.conf
+Abschnitt der Cloud
+  <IfModule mod_headers.c>
+    Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
+  </IfModule>
+dafür erforderlich Installation der Apache-Erweiterung mod_headers
+  sudo a2enmod headers
+Zum Ende Apache und PHP neu starten/laden
+  sudo systemctl reload php8.2-fpm.service
+  sudo systemctl restart apache2
+==== Update-Probleme ====
 [[https://ocloud.de/doc/admin/lang/de/configuration_server/occ_command.html|Infos zum OCC-Kommando]]
-Sollte das Update nicht bis zum Ende durchlaufen, hilft dieser Befehl - ausgeführt auf der Shell als root im Mainverzeichnis der HTML-Dateien.
+Sollte ein Update nicht bis zum Ende durchlaufen, kann es von der Konsole aus erneut aufgerufen werden - Ausführung im Mainverzeichnis der HTML-Dateien.
   sudo -u www-data php occ upgrade
+-u www-data = Im Namen von User www-data((User für Apache-Webbrowser)) ausführen \\
+php OCC = das PHP-Script OCC ausführen\\
+upgrade = Parameter für das PHP-Script \\
-===== Update auf Version 26 =====
+==== Datei-Reparatur ====
-Abarbeitung entsprechend Infos auf Nextcloud-Adminseite. \\
+. Dateiscan durchführen
-  sudo nano /etc/php/8.2/apache2/php.ini
+Als Webserver-Benutzer (www-data bei Debian - <USER> austauschen):
+  sudo -u www-data php /var/www/sites/nextcloud/occ files:scan --path="<USER>/files"
-  ;output_buffering = 4096           #deaktiviert, Semikolon davor gesetzt
+Oder den kompletten Benutzer scannen:
-  memory_limit = 512M                #geändert, war 128M
+  sudo -u www-data php /var/www/sites/nextcloud/occ files:scan <USER>
-  opcache.save_comments = 1          #war deaktiv => mit Semikolon davor
-  opcache.revalidate_freq = 60       #war mit Semikolon und = 2
-  opcache.validate_timestamps = 0    #war mit Semikolon und = 1
-  opcache.interned_strings_buffer=16 #war mit Semikolon und = 8
-Für Nextcloud nachinstallieren
+. Gelöschte Einträge aus dem Dateicache entfernen
-  sudo apt-get install php-gmp php-bcmath php-imagick
+  sudo -u www-data php /var/www/sites/nextcloud/occ files:cleanup
-SVG-Erweiterung für php-imagick
-  sudo apt install libmagickcore-6.q16-6-extra
-  sudo systemctl restart apache2
-Datenbank-Indexe aufräumen - als root auf Konsole ausführen - im Verzeichnis .../cloud/htdocs/
+. Falls Vorschaubilder Probleme machen
-  sudo -u www-data php occ db:add-missing-indices
+  sudo -u www-data php /var/www/sites/nextcloud/occ preview:cleanup
-  sudo nano .../cloud/config/config.php
+. Integrität prüfen
-Hinzufügen
+  sudo -u www-data php /var/www/sites/nextcloud/occ files:scan-app-data
-  'default_phone_region' => 'DE',
-  sudo nano /etc/apache2/sites-available/bluegnu.de_cloud.conf
+. Wenn Dateien immer noch angezeigt werden
-Abschnitt der Cloud
+  sudo -u www-data php /var/www/sites/nextcloud/occ maintenance:repair
-  <IfModule mod_headers.c>
-    Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
-  </IfModule>
-dafür erforderlich Installation der Apache-Erweiterung mod_headers
+==== Papierkorb ====
-  sudo a2enmod headers
+Ein sehr voller Papierkorb kann zu erheblichen Performance-Problemen führen. \\
+Dateien, die durch eine Client-Sync-Nutzung, z.B. auf einem Windows-System, verschoben werden, landen zusätzlich im Papierkorb. Werden so große Veränderungen an der Struktur vorgenommen, kann der Papierkorb extrem voll werden. \\
+Es empfiehlt sich diesen regelmäßg zu leeren - z.B. über das Frontend auf der Webseite.
-PHP-Memorie-Cache installieren/konfigurieren
+===== Daten Austausch & Synchronisation =====
-  sudo apt install php-intl php-imagick php-apcu memcached php-memcache
+==== Thunderbird ====
+=== Kalender- und Kontakte ===
+Die Synchronisation erfolgt mit den Boardmitteln von Thunderbird. \\
+"Neuer Kalender im Netzwerk" oder "CardDav-Adressbuch hinzufügen". \\
-  sudo nano /var/www/bluegnu.de_cloud/config/config.php
+=== Anhänge in Cloud laden ===
-Hinzufügen
+Thunderbird App:** *cloud - FileLink für Nextcloud und ownCloud** \\
-  'memcache.local' => '\\OC\\Memcache\\APCu',
-Das nächste wurde später wieder deaktiviert. Änderung stattdessen in der apcu.ini
+Mit der App lassen sich Dateien teilen bzw. indirekt senden. \\
-  sudo nano /etc/php/8.2/apache2/php.ini
+Anwendungsmöglichkeiten: **Anhang zu E-Mail, Termin, Aufgabe** \\
-Hinzufügen
-  apc.enable_cli=1
-  sudo nano /etc/php/8.2/mods-available/apcu.ini
+Zugangsdaten zur Cloud müssen hinterlegt werden: **Einstellungen -> Verfassen -> Anhänge** \\
-Hinzufügen
+Die Zugriffsberechtigung (Passwort) und die Aufbewahrungsdauer der Dateien können ebenfalls dort festgelegt werden. \\
-  extension=apcu.so
+Ein Ordner in der Nextcloud-Instanz wird ausgewählt, in dem die Datei(en) abgelegt werden. \\
-  apc.enable_cli=1
-  sudo systemctl restart apache2
+Quelle: [[https://kaffeeringe.de/2018/01/03/nextcloud-und-thunderbird-perfekt-verbinden/|kaffeeringe.de]] \\
+==== Windows ====
+Desktop-Software [[https://github.com/nextcloud/desktop/releases/download/v3.6.2/Nextcloud-3.6.2-x64.msi| downloaden]] und installieren. \\
+Während der Kontoeinrichtung wird man auf die Internetseite der Cloud-Installation geleitet - dort muss man den Daten-Zugriff für das Gerät freigeben.
+==== Android ====
+Fotos vom Handy im Hintergrund und automatisch auf die Nextcloud hochladen. \\
+Hierfür wird die Nextcloud-App auf dem Smartphone benötigt. \\
+Einstellungen -> Automatisches Hochladen -> Konfigurationsseite öffnet sich \\
+Lokaler Ordner -> Ordner, in dem das Smatphone die Fotos speichert. \\
+Typisch / Beispiel: Hauptspeicher -> DCIM -> Camera \\
+Remote-Ordner -> Ordner auf dem Nextcloud-Server, in den die Fotos geladen werden sollen. \\
+Zugriffe entsprechend benötigter Vorgaben einstellen. \\
 ===== Ressourcen anlegen =====
-Klappt derzeit nur über die Shell nicht übers Frontend. \\
+Installation der App [[https://github.com/nextcloud/calendar_resource_management|calendar_resource_management]] in der Nextcloud-Instanz.
-Nutzbar z.B. für Termine. \\
-  * Adressen
+Einrichtung aktuell((August 2024)) nur über die Shell, nicht übers Frontend. \\
-  * Stories
+Terminkoordination von: \\
-  * Räume
+  * Räumen
+  * Fahrzeugen
   * Ressourcen
-  * Fahrzeuge
-  * Restriktionen
-https://github.com/nextcloud/calendar_resource_management
+Die benannten Räume oder Ressourcen stehen nach folgenden Eingaben im Kalender auf dem Frontend zur Verfügung. Die Ressourcen werden in den Terminen hinterlegt und können auch von anderen Programmen (Thunderbird, etc.) eingesehen werden. Eine Planung über freie Ressourcen ist derzeit nur über die Weboberfläche von Nextcloud möglich. \\
-===== Kalender- und Kontakte-Synchronisation Thunderbird =====
+Beispiele (Befehle jeweils auf der Shell im Hauptverzeichnis der Cloud abgeben)\\
-Add-ons installieren:
+Details siehe: [[https://github.com/nextcloud/calendar_resource_management?tab=readme-ov-file#calendar-resource-management|Calendar Resource Management]]
-  * TbSync
-  * Provider für CalDAV & CardDAV
-TbSync starten und Login-Daten einpflegen. \\
+**Adresse anlegen** (erforderlich für Etage)
-Zu synchronisierende Elemente auswählen.
+  sudo -u www-data php occ calendar-resource:building:create --address="Domstr. 1, 50000 Cologne, Germany" "Office Cologne"
+Eingabe: 1: Adresse | 2: Bezeichnung \\
+**Etage anlegen** (erforderlich für Raum)
+  sudo -u www-data php occ calendar-resource:story:create 1 "5. Floor"
+Eingabe: 1: ID | 2: Bezeichnung \\
+**Raum anlegen** (Angabe der E-Mail ist Pflicht, kann aber eine Fake-E-Mail sein)
+  sudo -u www-data php occ calendar-resource:room:create 1 "myhomeoffice" "koeln_home_office" "homeoffice.koeln@bluegnu.de" "home office"
+Eingabe: 1: ID | 2: UID | 3: Bezeichnung | 4: E-Mail | 5:Raumtyp \\
+Optionen((zwischen create und ID)): --wheelchair-accessible=1 --capacity=25 --room-number=201 \\
+**Allgemeine Ressource anlegen**
+  sudo -u www-data php occ calendar-resource:resource:create "projetor1" 1 "Projektor 1" "projektor1.homeoffice.koeln@kspi.de" "Projektor"
+Eingabe: 1: UID | 2: building_id((Adresse)) | 3: Bezeichnung | 4: E-Mail | 5:Ressourcentyp \\
+**Ressourcen anzeigen**
+  sudo -u www-data php occ calendar-resource:resources:list
+**Raum löschen**
+  sudo -u www-data php occ calendar-resource:resource:delete "room" 1
-Es gab eine Problem mit der Netzwerk-Synchronisation der Kalender, da Termine jeweils (laut Meldung) kurz zuvor geändert wurden. \\
-Lösung: TbSync bietet je Konto drei Reiter (Synchronisationsstatus, Kontoeinstellungen und Optionen). \\
-Unter Optionen das Feld "Offline-Unterstützung" deaktivieren. \\
-Sollte das nicht bearbeitbar sein: im Reiter Synchronisationsstatus, das Konto deaktivieren, dann die Offline-Unterstützung auch deaktivieren, anschließend das Konto wieder aktivieren.
-===== Daten-Synchronisation Windows =====
+Nutzung über die Kalender-App: \\
-Desktop-Software [[https://github.com/nextcloud/desktop/releases/download/v3.6.2/Nextcloud-3.6.2-x64.msi| downloaden]] und installieren. \\
+Möglicherweise muss der erste Buchstabe der Ressource (display-name) bei Anlage eines Termins angegeben werden, um diesen zu finden. Ohne Eingabe bleibt die Auswahl möglicherweise komplett leer.
-Während der Kontoeinrichtung wird man auf die Internetseite der Cloud-Installation geleitet - dort muss man den Daten-Zugriff für das Gerät freigeben.
-~~DISCUSSION~~