search

SEPIA-Framework / sepia-docs

Documentation and Wiki for SEPIA. Please post your questions and bug-reports here in the issues section! Thank you :-)
https://sepia-framework.github.io/
237 stars 16 forks source link

Verbesserungsvorschläge für Dokumentation zur Installation in Docker #59

Open Byolock opened 4 years ago

Byolock commented 4 years ago

Is your feature request related to a problem? Please describe.

1 . Der Konsolenoutput spricht von Port 20726 nur wenn man NGINX installiert hat. 

DONE - If you made it this far all should be GOOD, but please double-check the output.

You should be able to reach your SEPIA server via:
53075d15eae3.local or [IP]

Example1: http://53075d15eae3.local:20721/tools/index.html
Example2: http://[IP]:20721/tools/index.html
Example3: http://[IP]:20721/app/index.html

If you've installed NGINX proxy with self-signed SSL try:
Example4: https://53075d15eae3.local:20726/sepia/assist/tools/index.html
Example5: https://53075d15eae3.local:20726/sepia/assist/app/index.html

Please note: if this is a virtual machine the hostname might not work to contact the server!

For more info about secure context and microphone access in the SEPIA client see: 
https://github.com/SEPIA-Framework/sepia-docs/wiki/SSL-for-your-Server

Bei einer Docker installation ist NGINX jedoch automatisch installiert, was nicht auf anhieb erkennbar ist und das standard Portmapping nimmt ebenfalls 20726 als port. Da kein self-signed SSL erstellt wurde geht HTTPS nicht. Der Richtige Zugriff ist also http://ip:20726/sepia/assist/tools/index.html#!home

2 . Der Letzte Befehl unter " Set Up Sepia " (https://registry.hub.docker.com/r/sepia/home/) beendet die Docker Instanz sobald das Terminal geschlossen wird, ist als Start Befehl für den Produktivbetrieb daher unbrauchbar.

3 . Unter https://registry.hub.docker.com/r/sepia/home/ hat die Überschrift "Set up Elasticsearch" dazu geführt das ich einen eigenen Elasticsearch Container erstellt habe da ich nicht wusste das der SEPIA Container bereits eine Elasticsearch installation enthält. Da nicht explizit erwähnt wird das ein Elasticsearch Container erstellt werden soll war dies natürlich voreilig von mir und eventuell bin ich der einzige der dies falsch verstanden hat.

Describe the solution you'd like

Für 1 : Ich würde vorschlagen den korrekten Zugang für Docker Installationen hinter Please note: if this is a virtual machine the hostname might not work to contact the server!

zu erwähnen.

Für 2 :

Besser folgenden Befehl angeben oder erwähnen das dieser den Server nicht dauerhaft laufen lässt: docker run -d --restart=unless-stopped --name=sepia_home -p 20726:20726 -it -v sepia-home-share:/home/admin/SEPIA sepia/home:v2.5.0

Für 3 :

In der Anleitung vermerkten das kein seperater Container gebraucht wird, falls die Formulierung so eingeschätzt wird das mein Fehler auch anderen unterlaufen könnte.

fquirin commented 4 years ago

Hi,

danke für die Hinweise. Werde es beim nächsten Update berücksichtigen :+1: :slightly_smiling_face: