← amrhein.info English
Handbuch · 01

Installation

In diesem Kapitel installieren Sie SD Migrator auf Ihrem Raspberry Pi 5. Außerdem lernen Sie, wie Sie das Programm aktualisieren oder entfernen und den Pi für den Einsatz unterwegs vorbereiten.

Voraussetzungen

  • Raspberry Pi 5
  • Raspberry Pi OS 64 Bit (Debian 13 „trixie“)
  • Das Installationspaket sd-migrator_<version>_arm64.deb

SD Migrator wird als normales Systempaket installiert. Sicherheitsupdates erhalten Sie daher zusammen mit den üblichen Systemaktualisierungen über apt. Alle benötigten Zusatzprogramme installiert das Paket automatisch mit.

SD Migrator installieren

  1. Kopieren Sie das Installationspaket auf den Pi und öffnen Sie dort ein Terminal im selben Ordner.
  2. Installieren Sie das Paket:
sudo apt install ./sd-migrator_<version>_arm64.deb
  1. Geben Sie Ihrem Benutzer Admin-Zugriff, damit Sie SD Migrator ohne sudo verwalten können:
sudo adduser "$USER" sd-migrator
  1. Melden Sie sich ab und wieder an, damit der Admin-Zugriff wirksam wird.

Das Paket richtet bei der Installation alles Nötige ein, darunter die Grundeinstellungen und das Sicherheitszertifikat für die verschlüsselte Verbindung zur Weboberfläche.

SD Migrator aktualisieren

Zum Aktualisieren verwenden Sie denselben Befehl wie bei der Installation, nur mit der neuen Paketdatei:

sudo apt install ./sd-migrator_<version>_arm64.deb

Ein Update überschreibt Ihre Einstellungen nie.

Wenn das Update abgelehnt wird

Ein Update oder das Entfernen startet SD Migrator neu. Läuft gerade ein Auftrag (Kopieren, Prüfen, Cloud-Upload), lehnt das Paket deshalb den Vorgang ab und nennt Ihnen den laufenden Auftrag.

  1. Warten Sie, bis der Auftrag fertig ist, oder brechen Sie ihn ab.
  2. Starten Sie das Update erneut.

Wenn Sie das Update trotzdem sofort durchführen wollen, erzwingen Sie es so:

sudo SD_MIGRATOR_FORCE=1 apt install ./sd-migrator_…_arm64.deb

Achtung: Ein erzwungenes Update unterbricht den laufenden Auftrag.

Tipp: Dieser Schutz greift erst bei Updates von Version 0.4.5 an. Entscheidend ist die bereits installierte Version, nicht die neue.

SD Migrator entfernen

  • Nur das Programm entfernen:
sudo apt remove sd-migrator
  • Programm samt Einstellungen, Zugangsdaten, Zertifikaten und Statusdaten entfernen:
sudo apt purge sd-migrator

Ihre gesicherten Medien bleiben in beiden Fällen immer erhalten.

iCloud Drive für das Cloud-Backup freischalten (optional)

Für Dropbox, Google Drive, OneDrive und pCloud reicht die mitgelieferte Ausstattung. Für iCloud Drive brauchen Sie rclone ab Version 1.69; Debian 13 liefert nur 1.60. Ersetzen Sie es durch das offizielle Paket von rclone.org:

V=$(curl -fsSL https://downloads.rclone.org/version.txt | cut -d' ' -f2)
curl -fsSLO "https://downloads.rclone.org/$V/rclone-$V-linux-arm64.deb"
curl -fsSL "https://downloads.rclone.org/$V/SHA256SUMS" | grep "linux-arm64.deb" | sha256sum -c -
sudo apt install "./rclone-$V-linux-arm64.deb"

Empfohlene Einstellungen am Pi

Pi ganz ausschalten statt nur anhalten

Standardmäßig hält der Pi 5 beim Herunterfahren nur an. So schaltet er sich vollständig aus:

  1. Öffnen Sie die Einstellungen:
sudo rpi-eeprom-config --edit
  1. Setzen Sie POWER_OFF_ON_HALT=1 und speichern Sie.
  2. Starten Sie den Pi neu. Die Einstellung ist einmalig nötig und gilt ab dem Neustart.

Grafischen Desktop abschalten

Sie bedienen SD Migrator ausschließlich über die Weboberfläche. Schalten Sie den grafischen Desktop ab:

sudo raspi-config nonint do_boot_behaviour B1

Achtung: Bleibt der Desktop aktiv, bindet er eingesteckte Laufwerke selbst ein. SD Migrator kann diese Laufwerke dann nicht lesen.

Zurück zum Desktop gelangen Sie mit:

sudo raspi-config nonint do_boot_behaviour B4

Laufwerke vorbereiten

Verwenden Sie für große Videodateien Laufwerke mit dem Dateisystem ext4 oder exFAT.

Achtung: FAT32 erlaubt nur 4 GiB pro Datei. Lange Videos passen darauf oft nicht.

SD Migrator formatiert und partitioniert niemals Laufwerke. Bereiten Sie Ihre Laufwerke daher vorher selbst vor.