Doku ioBroker Linux + Docker Installation Update

[Feuersturm]

Nachdem die Anleitung in der Doku überarbeitet ist, wie man ioBroker unter Windows installiert habe ich mir auch einmal die Linux Installations Anleitung vorgenommen.
Das hier ist die aktuelle Seite in der Dokumentation: https://www.iobroker.net/#de/documentation/install/linux.md
Ich habe die Seite etwas umstrukturiert und die Anleitung aufgeteilt in Installation auf einem Pi, Linux und Docker.
Wenn man später noch einmal die Doku etwas umstrukturiert kann man auch eine eigene Seite für Docker anlegen, dies ist aber soweit ich weiß nicht so einfach möglich, daher ist das aktuelle Ziel erstmal den Inhalt zu verbessern und verschieben kann man ihn dann später noch.

Ziel der Seite ist, dass beschrieben wird wie die reine Installation (keine Pflege, keine Systeupdates etc.) von ioBroker unter Linux / Docker erfolgt.
Im nächsten Schritt (dafür wird es eine seperte Diskussion geben), soll das Thema Onboarding / Erste Schritte, Wie pflege und aktualisiere ich mein System, Backups und Wiederherstellung dann diskutiert und in die Doku übernommen werden.

Der aktuelle Arbeitsstand:
https://github.com/Feuer-sturm/ioBroker.docs/blob/Doc-Install-Linux/docs/de/install/linux.md

Und jetzt seid ihr wieder dran. Was fehlt noch aus eurer Sicht, was muss umformuliert werden?
@Thomas-Braun @Homoran @Jey-Cee @dp20eic @andre und alle anderen

[Jey Cee]

@feuersturm ich weis man kann es nicht Oft genug sagen, aber reicht nicht trotzdem einmal in FETT:

KEINE Installation (Ausführung des Installationsskriptes) von ioBroker als root User!.Erstelle einen normalen User (der nicht iobroker heißt) mit welchem das System administriert wird

Verwende für die Installation einen normalen User und verwendet NICHT den root User

&&

Voraussetzungen prüfen

Vielleicht als ersten Punkt nehmen dann reicht einmal.

---

Je nach Hardware kann die Installation dauern.

Vorschlag:
Je nach Hardware kann die Installation etwas Zeit in Anspruch nehmen.

---

Typos:

ioBroker kann nun über die angegebene IP im Webbrowser aufrufen werden http://<IP-Adresse>:8081 und eingerichtet werden.

aufgerufen

Eine Desktop Umgebung verbraucht unnötige Ressourcen vergrößert das Fehlerpotential

Eine Desktop Umgebung verbraucht unnötige Ressourcen und vergrößert das Fehlerpotential

[Feuersturm]

@jey-cee sagte in Doku ioBroker Linux + Docker Installation Update:

Voraussetzungen prüfen

Vielleicht als ersten Punkt nehmen dann reicht einmal.

Danke für dein Feedback Ich habe deine Vorschläge eingearbeitet.
Meintest du mit dem Hinweis "Voraussetzung prüfen", dass der Abschnitt nur einmal enthalten sein soll? Ich hatte ihn bewusst doppelt drin, so dass man später den Abschnitt Docker einfach auf eine andere Seite verschieben kann.

[Jey Cee]

@feuersturm sagte in Doku ioBroker Linux + Docker Installation Update:

Meintest du mit dem Hinweis "Voraussetzung prüfen", dass der Abschnitt nur einmal enthalten sein soll?

Ja.

@feuersturm sagte in Doku ioBroker Linux + Docker Installation Update:

Ich hatte ihn bewusst doppelt drin, so dass man später den Abschnitt Docker einfach auf eine andere Seite verschieben kann.

Dacht ich mir schon.

[A Former User]

@feuersturm

Moin,

Zu

KEINE Installation (Ausführung des Installationsskriptes) von ioBroker als root User!. Erstelle einen normalen User (der nicht iobroker heißt) mit welchem das System administriert wird

Ich bekomme da ein Fragezeichen im Kopf, denn in der Einleitung steht

Während der Installation wird im System ein neuer Benutzer “iobroker” angelegt sowie ein zugehöriges Home-Verzeichnis (/home/iobroker). Der ioBroker läuft dann unter dem User "iobroker".

also wieso muss ich da erst einen User anlegen?
Also, nicht das Ihr denkt ich habe da wirklich ein Fragezeichen, ist halt nur mal aus der Sicht eines nicht ITlers.
Ich würde auch den Satz nicht zerlegen, sondern es so schreiben

KEINE Installation von ioBroker als **root** User! Das Ausführen des Installationsskriptes **muss** als ein normaler User durchgeführt werden,
durch diesen User wird auch das System zukünftig administriert. Der `normale` User sollte, nicht `iobroker` heißen, es sollte der bei
der Basisinstallation, angelegte User sein.

VG
Bernd

Edit
nur mal den Zeilenumbruch, eingefügt

[Meister Mopper]

@feuersturm

Warum kein beherztes sudo apt update && sudo apt full-upgrade? Gibt es da Fallstricke?

[Feuersturm]

@meister-mopper sagte in Doku ioBroker Linux + Docker Installation Update:

@feuersturm

Warum kein beherztes sudo apt update && sudo apt full-upgrade? Gibt es da Fallstricke?

Auf welche Passage beziehst du dich? Hier https://github.com/Feuer-sturm/ioBroker.docs/blob/Doc-Install-Linux/docs/de/install/linux.md#linux steht

Über die Konsole und je nach verwendetem OS ein System-Update mit sudo apt update && sudo apt full-upgrade durchführen.

[Feuersturm]

@dp20eic Dankeschön, hab deinen Vorschlag in den aktuellen Arbeitsstand übernommen.

[Feuersturm]

Pullrequest ist erstellt https://github.com/ioBroker/ioBroker.docs/pull/462

[crunchip]

@feuersturm die Verlinkung funktioniert nicht bei
https://www.iobroker.net/#de/documentation/install/docker.md

Vor der Installation prüfe bitte, ob das System alle notwendigen Installationsvoraussetzungen erfüllt.

(./requirements.md)

ebenso bei
https://www.iobroker.net/#de/documentation/install/linux.md

[Feuersturm]

@crunchip Danke.
Auf github sieht es aktuell so aus:

Vor der Installation prüfe bitte, ob das System alle notwendigen [Installationsvoraussetzungen](./requirements.md) erfüllt.

Dies Seite linux.md und requirements.md liegen im gleich Ordner (https://github.com/ioBroker/ioBroker.docs/tree/master/docs/de/install)
Kann mir jemand sagen, wie die korrekte Syntax für die Verlinkung ist? @Homoran @apollon77 damit es mit dem Doku Framework funktioniert?
Wenn ich direkt auf der github Seite https://github.com/ioBroker/ioBroker.docs/blob/master/docs/de/install/linux.md den Link im Abschnitt "Voraussetzungen prüfen" anklicke funktioniert der Link.

[Homoran]

@feuersturm sagte in Doku ioBroker Linux + Docker Installation Update:

Kann mir jemand sagen, wie die korrekte Syntax für die Verlinkung ist? @Homoran @apollon77 damit es mit dem Doku Framework funktioniert?

leider nein. Hab ich auch nie hinbekommen

[crunchip]

@feuersturm sagte in Doku ioBroker Linux + Docker Installation Update:

Kann mir jemand sagen, wie die korrekte Syntax für die Verlinkung ist?

wenn du anstatt ./requirements.md
die gesamte Adresse einträgst
https://www.iobroker.net/#de/documentation/install/requirements.md

[Feuersturm]

@crunchip Das passt dann aber nicht, wenn die Seiten automatisch übersetzt werden. So würde man hart auf die deutsche Version verlinken. Mein Ziel war es eigentlich releativ auf das ander *.md Dokument zu verweisen, so dass abhängig von der eingestellten Sprache auch die korrekte Datei verlinkt wird.

[crunchip]

@feuersturm so steht es aber bei mehreren Seiten, siehe z.b
https://github.com/ioBroker/ioBroker.docs/edit/master/docs/de/admin/README.md

[Feuersturm]

@crunchip Schalte mal in der Doku oben die Sprache um auf EN und gehe dann wieder auf die von dir verlinkte Seite und folge einem Link. Der Link führt dann auf die deutsche Seite, was aus meiner Sicht ja nicht das Ziel sein kann

[crunchip]

@feuersturm sagte in Doku ioBroker Linux + Docker Installation Update:

Schalte mal in der Doku oben die Sprache um

ich verstehe was du meinst, aber wie geschrieben, da müsste man ja sämtliche Seiten überarbeiten und wüsste jetzt auch nicht wie man das anders einträgt

[Feuersturm]

@crunchip Jep, das wäre aber nur eine Fleißaufgabe und ist vermutlich schneller gemacht als neuen Inhalt zu schreiben

[apollon77]

mal andere stellen in der doku gesucht wo es solche links gibt die tun? SOnst muss man das als issue in docs machen und Bluefox fragen

[Feuersturm]

@apollon77 Ich hab keine Stelle in der Doku gefunden wo ein relativer Link verwendet wird und funktioniert. Ich hab mich mal hier an das issue https://github.com/ioBroker/ioBroker.docs/issues/260#issuecomment-1826443729 dran gehängt.