====== Die Installation von LoxBerry ====== ====== Vorbereitungen ====== Zur Installation des LoxBerry benötigt ihr verschiedene kostenlose Software. Ladet Euch die Software für euer Betriebssystem herunter und installiert diese entsprechend. * PuTTY: [[https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html|https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html]] * Optional je nach Zielsystem: Balena Etcher (nur für Single Board Computer): [[https://www.balena.io/etcher|https://www.balena.io/etcher]] * Optional je nach Zielsystem: 7-ZIP Dateimanager: [[https://www.7-zip.de|https://www.7-zip.de]] ====== Image Vorbereitung ====== LoxBerry basiert seit LoxBerry 3.0 auf dem [[https://dietpi.com/|Diet Pi Image]]. Diet Pi ist für eine sehr große Anzahl an SBC (Single Board Computer) sowie auch Virtual Machines oder auch PCs verfügbar. Sämtliche wichtige SBC wie der Raspberry Pi 1 bis 4, Odroid, Orange Pi, Rock Pi, Asus Tinkerboard usw. werden unterstützt. An VM-Systemen stehen Virtual Box, VMWare, Proxmox, Microsoft HyperV sowie auch native X86_64 Systeme zur Verfügung. Die Installation des LoxBerry gliedert sich in zwei Schritte: Zunächst installiert ihr Diet Pi (das Betriebssystem) in der Minimalvariante und anschließend den LoxBerry. Nachdem die Installation abgeschlossen ist, wird das gesamte System über die LoxBerry Browser-basierte Bedienoberfläche konfiguriert und bedient. **Aber keine Angst: Die Installation schafft jeder mit rudimentären Computerkenntnissen.** 8-) Als erstes ladet ihr Euch das passende Image für eurer System herunter. Dazu geht ihr auf [[https://dietpi.com/#downloadinfo]] und sucht Euch das passende Image für euer System aus und ladet es auf euren PC herunter. {{installation_von_loxberry:pasted:20230207-113406.png?600}} Das Diet Pi Image ist im Dateiformat XV komprimiert (Dateiendung .xv). Nun geht es je nach Zielsystem etwas unterschiedlich mit der Installation weiter. Sollte Euch unsere Beschreibung nicht genügen, könnt ihr in der Dokumentation von Diet Pi ausführliche Informationen zu eurem System finden: [[https://dietpi.com/docs/install|https://dietpi.com/docs/install]] ====== Image Installation ====== Je nach Hardware geht es nun etwas unterschiedlich weiter. Springt in die Anleitung für eurer Zielsystem. Wenn ihr die Image Imstallation durchgeführt habt, geht es hier mit der Ersteinrichtung weiter. {{indexmenu>.}} ====== Diet Pi Erstkonfiguration ====== Nach dem ersten Booten wird nun zunächst das Grundsystem von Diet Pi eingerichtet. Loggt Euch dazu entweder auf der Konsole über Bildschirm und Tastatur oder aber über das Netzwerk per [[https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html|SSH mit PuTTY]] auf eurem Diet Pi ein. Wir zeigen im folgenden den Zugriff per PuTTY. Ihr benötigt für den Zugriff auf den Diet Pi entweder die IP-Adresse des Diet Pi, die euer Router vergeben hat, oder ihr könnt versuchen ihn über seinen Namen ''dietpi'' zu erreichen. Oft funktioniert der Zugriff über den Namen, ansonsten müsst ihr die vergebene IP-Adresse in eurem Router nachschauen. Startet PuTTY und gebt im Feld "Host Name" entweder ''dietpi'' als Hostnamen ein oder eben die IP-Adresse, die ihr aus eurem Router herausgesucht habt. Weitere Einstellungen sind nicht notwendig - klickt auf "Open" und es sollte sich eine Verbindung aufbauen. Nachdem ihr die Sicherheitsmeldung bestätigt habt, solltet ihr den Login eures Diet Pi sehen. {{installation_von_loxberry:pasted:20230207-125049.png?350}} Die Logindaten beim ersten Booten des Diet Pi lauten: **Login:** ''root'' **Passwort:** ''dietpi'' Sobald ihr Euch eingeloggt habt, beginnt Diet Pi sofort mit dem Update einiger Pakete. Anschließend seht ihr das Menü für die Erstkonfiguration. Als erstes fragt Euch das Setup, ob ihr zwei Systempasswörter nun ändern wollt. Das machen wir an dieser Stelle nicht (der LoxBerry erledigt das später für uns) und brechen beide Anfragen mit "Cancel" ab. {{installation_von_loxberry:pasted:20230207-125437.png?450}} {{installation_von_loxberry:pasted:20230207-125515.png?450}} Je nachdem auf welchem Gerät ihr den LoxBerry installiert, fragt Euch das Setup nun noch, ob ihr die serielle Konsole einrichten wollt. Auch das beantworten wir mit "No", da der LoxBerry diese Konfiguration später selbst vornimmt. {{installation_von_loxberry:pasted:20230207-125648.png?400}} Im nun folgenden Menü installieren wir über "Install" das Minimalsystem des Diet Pi. Alle anderen Softwarepakete installiert der LoxBerry später selbst, ihr müsst hier also nichts weiter tun. {{installation_von_loxberry:pasted:20230207-125816.png?400}} {{installation_von_loxberry:pasted:20230207-125852.png?400}} Zuletzt könnt ihr Euch noch entscheiden, ob euer Diet Pi in der Statistik vom Diet Pi Projekt erscheinen soll. Wenn dann alles geklappt hat, landet ihr am Login Prompt von Diet Pi. Die Konfiguration von Diet Pi ist damit schon abgeschlossen! {{installation_von_loxberry:pasted:20230207-130039.png?400}} ====== LoxBerry Installation ====== Nun geht es gleich weiter mit der Installation vom eigentlichen LoxBerry. Zur Installation ist nur ein einziger Befehl auf der Kommandozeile notwendig (hier per Maus kopieren und im PuTTY Fenster mit der rechten Maustaste einfügen - dann mit ''ENTER'' ausführen). ''%%wget https://raw.githubusercontent.com/mschlenstedt/Loxberry_Installer/main/install.sh && bash install.sh | tee /boot/loxberry_install.log%%'' Die Installation läuft nun automatisch ab. Das kann je nach Hardware bis zu 2 Stunden dauern. Du kannst auf dem Bildschirm verfolgen was gerade passiert. Am Ende der Installation musst Du mit dem Befehl ''reboot'' den Diet Pi (besser gesagt: den LoxBerry :-)) neu starten. Achte darauf, dass die Netzwerkverbindung während der Installation nicht abbricht, ansonsten wir die Installation abgebrochen! Häufig passiert das bei WLAN-Verbindungen. Nutze lieber für die Erstinstallation ein LAN-Kabel. Die Installation ist erst vollständig abgelaufen, wenn Du eine Erfolgsmeldung im PuTTY-Fenster sehen kannst! Anschließend kannst Du den LoxBerry über Deinen Browser erreichen. Achtung! Der Hostname ist nun ''loxberry'' und nicht mehr "dietpi"! Die gesamte Konfiguration des LoxBerry erfolgt nun per Browser. Die standardmäßig aktivierten Zugangsdaten sind wie folgt: **Browser Login:** ''loxberry'' **Browser Passwort:** ''loxberry'' **Konsolen-/SSH Login:** ''loxberry'' **Konsolen-/SSH Passwort:** ''loxberry'' **Root Passwort:** ''loxberry'' (SSH Login ist gesperrt) - wird nach dem ersten Login neu gesetzt! ==== Sonderfall: Direkt mit Wifi (ohne Ethernet) booten / Statische IP-Adresse ==== Wenn möglich verbindet euren Raspberry für die Erstinstallation zunächst über Ethernet und mit Vergabe der IP-Adresse per DHCP - das ist die einfachste Methode. Ihr könnt Wifi / WLAN oder eine statische IP-Adresse zu einem späteren Zeitpunkt jederzeit noch über die Konfigurationsoberfläche des LoxBerry bequem einrichten. Müsst ihr auch die Ersteinrichtung bereits über Wifi durchführen, könnt und müsst ihr den LoxBerry nach der Installation **und vor dem ersten Re-Booten** bereits für die Wifi-Verbindung einrichten. Das Gleiche gilt, wenn eurer Diet Pi keine dynamisch zugewiesene IP-Adresse per DHCP von eurem Router erhält. Auch in diesem Fall könnt und müsst ihr die statische IP-Adresse vor dem ersten Booten festlegen. Dazu startet ihr **vor dem ersten Reboot** direkt das Programm Dietpi-Config, indem ihr auf der Konsole ''dietpi-config'' gefolgt von eingebt. Wechselt dann zum Menüpunkt ''7: Network Options: Adapters'' und konfiguriert euer Netzwerk entsprechend eurem Bedarf. Weitere Infos erhaltet ihr hier: [[https://dietpi.com/docs/dietpi_tools/system_configuration/]] Anschließend könnt ihr den LoxBerry neu starten, indem ihr ihn mit ''reboot'' neu startet.. {{installation_von_loxberry:die_installation_von_loxberry:pasted:20250412-080117.png?400}} == Veraltete Methode (nicht mehr zu empfehlen!) == Steckt dazu die SD-Karte vor dem ersten Re-Booten noch einmal in euren Windows-PC und wechselt zu der lesbaren Bootpartition auf der SD-Karte. Legt dort eine neue Datei ''%%network.txt%%'' mit einem Texteditor eurer Wahl (z. B. [[https://notepad-plus-plus.org/|Notepad++]]) an. Um per Wifi zu booten, kopiert folgenden Ihalt in die Datei und passt die Daten entsprechend eurem WLAN an: auto lo iface lo inet loopback allow-hotplug wlan0 iface wlan0 inet dhcp wpa-ssid INSERT_YOUR_WLAN_SSID wpa-psk INSERT_YOUR_WLAN_PASSWORD Solltet ihr stattdessen (oder auch zusätzlich) eine statische IP-Adresse vergeben wollen, müsst ihr folgende Angaben die die Datei übernehmen: auto lo iface lo inet loopback # The primary network interface # If WLAN, use wlan0 here! auto eth0 iface eth0 inet static address 192.168.2.236 netmask 255.255.255.0 gateway 192.168.2.254 dns-domain sweet.home dns-nameservers 192.168.2.254 1.1.1.1 8.8.8.8 Speichert die Datei ab. Nun könnt ihr die SD-Karte in euren SBC stecken und booten. ====== Optional: Router konfigurieren ====== Es ist wichtig, dass der Loxone Miniserver und LoxBerry miteinander kommunizieren können. [[https://loxwiki.atlassian.net/wiki/spaces/LOX/pages/1529023318|Werden Hostnamen verwendet]], sollte das automatisch funktionieren, um aber auf "Nummer Sicher" zu gehen, kann am Router konfiguriert werden, dass LoxBerry immer die gleiche IP-Adresse erhält. Wenn es nach einem Stromausfall oder dergleichen zu Problemen mit der Kommunikation gibt, solltest du das einrichten. Die meisten Router bieten dazu eine entsprechende Option an, bestimmten Geräten immer die gleiche IP-Adresse per DHCP zuzuweisen. Bei den bekannten Fritzboxen findet man die Einstellung unter Heimnetz → Heimnetzübersicht und anschließend "Details". Hier hakt man die Option "Diesem Netzwerkgerät immer die gleiche IPv4-Adresse zuweisen" an. {{:installation_von_loxberry:1207501905.png?600}} ====== Geschafft! ====== Jetzt führst du am Besten die [[konfiguration:erste_schritte]] aus.