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 mit weniger, als 4 GB RAM) 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. Um diese Suche zu testen, können Sie vor Ihren Suchbegriff "FORCE_DB_SEARCH:" (ohne Anführungszeichen) anstellen, dann wird die Suche immer auf der Datenbank und nicht auf dem Such-Server ausgeführt. Das können Sie auch auf unserer Demo-Instanz ausprobieren.

Das können Sie wie folgt erreichen:

    • Duplizieren Sie die Datei docker-compose-min.yml.example und benennen Sie das Duplikat in docker-compose.yml um.
    • Ändern Sie den Wert disable_search_server von false auf true in der Datei config/config.yml um.
      Falls noch keine config/config.yml vorhanden ist, dann duplizieren Sie die Datei config/config.yml.example und benennen Sie das Duplikat in config/config.yml um. 
    • Nun ist der Such-Server deaktiviert und Sie können mit der Anleitung hier fortfahren
    • Bitte überspringen Sie den zwei Befehle im nächsten Schritt, da Sie sonst Ihre eben erstellten Dateien überschreiben!

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):

cp config/config.yml.example config/config.yml
cp docker-compose.yml.example docker-compose.yml
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. Bitte ändern Sie das Passwort von dem Benutzer, wenn Sie sich das erste Mal angemeldet haben.

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.