Skip to main content

Installation und Betrieb - Ubuntu 18.04 / 20.04 / 22.04

Das wird vorausgesetzt:

Wenn Sie one folder käuflich erworben oder ein Abonnement abgeschlossen haben, erhalten Sie per E-Mail die Installationsdateien als Zip-Datei gepackt. Bitte entpacken Sie diese Zip-Datei an einen Ort Ihrer Wahl auf Ihren Server.

Wenn Sie die Zip-Datei ausgepackt haben, dann begeben Sie sich bitte mit der Konsole in das entpackte Verzeichnis.

Minimale Konfiguration ohne Such-Server (empfohlen für Raspberry Pi / NAS)

Wenn Sie one folder auf einem Server mit wenig Ressourcen (wie z.B. einen Raspberry Pi oder ein NAS) betreiben möchten, empfiehlt es sich den Such-Server zu deaktivieren, um Ressourcen zu sparen. Die Suche findet dann ausschließlich auf der Datenbank statt und die Suche ist dann minimal gröber eingestellt. 

Das können Sie wie folgt erreichen:

    • Löschen Sie die Datei docker-compose.yml und benennen Sie die Datei docker-compose-min.yml in docker-compose.yml um. 
    • Ändern Sie den Wert disable_search_server von false auf true in der Datei config/config.yml um.
    • Nun ist der Such-Server deaktiviert und Sie können mit der Anleitung hier fortfahren

Wenn Sie sich mit der Konsole im entpackten Verzeichnis befinden, dann führen Sie bitte die folgenden Befehle als Root-User aus (alle Befehle auf dieser Seite müssen in diesem Verzeichnis und mit dem Root-User ausgeführt werden):

mkdir es-data
chown -R 1000:1000 es-data
sysctl -w vm.max_map_count=262144
docker-compose up -d

Die ganze Installation wird nun ausgeführt und nach ca. 15 Minuten können Sie Ihre one folder - Instanz unter http://localhost:13000 erreichen. Einloggen können Sie sich initial mit test@test.de und dem Passwort admin

Nach erstmaliger Installation kann die Suche beim ersten oder zweiten mal Fehler verursachen oder länger dauern, da der Suchserver noch nicht komplett hochgefahren ist. Bitte probieren Sie es bei einen Fehler in 5 Minuten erneut, dann sollte die Suche immer ohne Probleme funktionieren.

Wenn Sie Ihren Server herunterfahren und danach wieder starten, können Sie wie folgt one folder hochfahren:

sysctl -w vm.max_map_count=262144
docker-compose down
docker-compose up -d

One folder ist eine Server-Applikation, d.h. der Betrieb ist auf einen dauerhaften Betrieb ausgelegt. Von einem täglichen Herunterfahren des Servers wird abgeraten, da es evtl. zu Problemen kommen kann, wenn one folder nicht ordnungsgemäß vorher runtergefahren wird.

Wenn Sie den Server herunterfahren wollen, dann empfiehlt es sich vorher one folder ordnungsgemäß herunterzufahren, das gelingt wie folgt

docker-compose down

Konfiguration

Sie müssen keine Einstellungen vornehmen, Sie können die obige Anleitung ausführen und one folder mit den bereits vorhandenen Standard-Einstellungen installieren.

Innerhalb der Datei config/config.yml haben Sie noch folgende Einstellmöglichkeiten:

  • disable_search_server
    • Deaktiviert den Such-Server und führt Suchanfragen nur auf der Datenbank aus.
  • es_host
    • Host des Such-Servers. Bitte nur ändern, falls Sie nicht den Standard-Suchserver verwenden!
  • es_port
    • Port des Such-Servers. Bitte nur ändern, falls Sie nicht den Standard-Suchserver verwenden! 
  • es_index
    • Indexname des Such-Servers. Bitte nur ändern, falls Sie nicht den Standard-Suchserver verwenden! 
  • allow_auto_bug_reports
    • Erlaubt das Senden von Fehlermeldungen an uns, um Fehler beheben zu können.