⌕
AnmeldenDabei sein ↗

Tippe mindestens zwei Buchstaben. Pfeiltasten wählen, Enter öffnet.

ANLEITUNG✳ Erste Schritte

Git für Einsteiger: Configs und Projekte versionieren, nie wieder „printer_alt2.cfg“

Git merkt sich jede Änderung an deinen Dateien und holt jeden alten Stand mit einem Befehl zurück. Ideal für Klipper-Configs, Docker-Compose-Dateien und Code. Mit allen Grundbefehlen und Spickzettel.

Laptop und gestapelte Dateien, daneben ein Versionsbaum aus grünen Punkten mit einem orangen Seitenzweig, der wieder zurückführt
Illustration: Spawnpunkt

printer.cfg, printer_alt.cfg, printer_alt2_funktioniert.cfg: Wer an Konfigurationsdateien bastelt, kennt dieses Durcheinander. Git löst das Problem sauber. Es speichert jede Version deiner Dateien mit Datum und Beschreibung, zeigt dir genau, was sich geändert hat, und holt jeden früheren Stand mit einem Befehl zurück.

Git ist nicht nur etwas für Programmierer. Es eignet sich für alles, was aus Textdateien besteht: Klipper-Konfigurationen, Docker-Compose-Dateien, Home-Assistant-Automationen, OpenSCAD-Modelle oder Notizen.

Du brauchst: einen Rechner mit Windows, macOS oder Linux. Als Beispiel versionieren wir die Klipper-Konfiguration auf einem Raspberry Pi (siehe https://spawnpunkt.de/magazin/klipper-kiauh-raspberry-pi-installieren), das Vorgehen ist aber überall gleich. Zeitaufwand: etwa 30 Minuten.

Die drei Begriffe, die du kennen musst

  • Repository (Repo): ein Ordner, dessen Änderungen Git verfolgt. Die Geschichte liegt im versteckten Unterordner .git.
  • Commit: ein gespeicherter Stand, wie ein Speicherpunkt im Spiel. Jeder Commit hat eine Beschreibung und eine eindeutige Kennung.
  • Staging: der Zwischenschritt vor dem Commit. Mit git add legst du fest, welche Änderungen in den nächsten Commit kommen.
Von links nach rechts: Datei, Pfeil in einen Ordner zum Vormerken, Pfeil zu einem verschnürten Paket als Commit und Pfeil zur Wolke für das Hochladen
Der Weg einer Änderung: Datei bearbeiten, mit git add vormerken, mit git commit speichern, optional mit git push hochladen.

Schritt 1: Git installieren und einrichten

Linux und Raspberry Pi:

bash
sudo apt update && sudo apt install -y git

Windows: in der PowerShell mit winget install --id Git.Git -e oder per Installer von git-scm.com. macOS: xcode-select --install im Terminal.

Danach sagst du Git einmalig, wer du bist. Name und E-Mail stehen in jedem Commit:

bash
git config --global user.name "Dein Name"
git config --global user.email "du@example.com"
git config --global init.defaultBranch main

Die letzte Zeile sorgt dafür, dass der Hauptzweig main heißt, wie bei GitHub üblich.

Schritt 2: Das erste Repository

Wechsle in den Ordner, den du versionieren willst, und mach ihn zum Repository:

bash
cd ~/printer_data/config
git init

Klipper legt bei jedem Speichern aus der Oberfläche Sicherungskopien wie printer-20261118_143012.cfg an. Die braucht Git nicht, denn das erledigt es jetzt selbst. Lege deshalb eine Datei .gitignore an, in der steht, was Git ignorieren soll:

bash
cat > .gitignore <<'EOF'
# Automatische Sicherungen von Klipper
printer-*.cfg
*.bkp
# Zugangsdaten nie versionieren
.env
*secret*
EOF

Jetzt den aktuellen Stand als ersten Commit speichern:

bash
git status
git add .
git commit -m "Ausgangszustand der Klipper-Konfiguration"

git status ist dein wichtigster Befehl. Er zeigt jederzeit, welche Dateien geändert, vorgemerkt oder neu sind.

Schritt 3: Der Alltag mit Git

Du änderst zum Beispiel den Z-Offset oder die Pressure-Advance-Werte in der printer.cfg. Bevor du speicherst, siehst du dir die Änderung an:

bash
git diff

Entfernte Zeilen erscheinen mit -, neue mit +. Passt alles, speicherst du den Stand mit einer Beschreibung, die dir in drei Monaten noch hilft:

bash
git add printer.cfg
git commit -m "Pressure Advance auf 0.045 nach Kalibrierung mit PETG"

Die Geschichte zeigt git log, kompakt in einer Zeile pro Commit:

bash
git log --oneline

Schritt 4: Zurück zu einem alten Stand

Die eigentliche Stärke: Fehler lassen sich in Sekunden rückgängig machen.

Ungespeicherte Änderungen verwerfen (Datei zurück auf den letzten Commit):

bash
git restore printer.cfg

Eine ältere Version einer Datei holen. Suche mit git log --oneline die Kennung des Commits, zum Beispiel a1b2c3d, und hol die Datei aus diesem Stand:

bash
git restore --source=a1b2c3d printer.cfg

Die Datei ist danach wieder so wie damals. Gefällt dir das, speicherst du es mit git commit -am "Zurück auf alte Werte" als neuen Stand. Nichts geht dabei verloren, auch die neuere Version bleibt in der Geschichte.

Schritt 5: Ausprobieren ohne Risiko mit Branches

Du willst Input Shaping testen, bist aber nicht sicher, ob es besser wird? Ein Branch ist eine Abzweigung, auf der du experimentierst, ohne den funktionierenden Stand anzufassen:

bash
git switch -c input-shaping
# … printer.cfg ändern, testen, committen …
git commit -am "Input Shaper mit ADXL345 gemessen"

Hat es geklappt, holst du die Änderungen in den Hauptzweig:

bash
git switch main
git merge input-shaping

War es nichts, wechselst du einfach mit git switch main zurück. Der alte Stand ist sofort wieder da.

Schritt 6: Online sichern mit GitHub, Codeberg oder Gitea

Ein Repository auf einem Server ist zugleich ein Backup außer Haus. Lege bei GitHub oder Codeberg ein privates Repository ohne README an. Für die Anmeldung nutzt du am besten einen SSH-Schlüssel, siehe https://spawnpunkt.de/magazin/ssh-schluessel-einrichten. Den öffentlichen Schlüssel trägst du in den Kontoeinstellungen unter „SSH and GPG keys“ ein. Dann verbindest du dein Repository und lädst es hoch:

bash
git remote add origin git@github.com:deinname/klipper-config.git
git push -u origin main

Ab jetzt reicht nach jedem Commit ein git push. Auf einem zweiten Rechner holst du das Repository mit git clone und aktualisierst es später mit git pull.

Spickzettel

BefehlWas er macht
git statuszeigt geänderte und neue Dateien
git diffzeigt die Änderungen Zeile für Zeile
git add dateimerkt eine Änderung für den Commit vor
git commit -m "…"speichert den vorgemerkten Stand
git commit -am "…"vormerken und speichern in einem (nur bekannte Dateien)
git log --onelinezeigt die Geschichte kompakt
git restore dateiverwirft ungespeicherte Änderungen
git restore --source=ID dateiholt eine Datei aus einem alten Commit
git switch -c nameneuen Branch anlegen und wechseln
git merge nameBranch in den aktuellen übernehmen
git push / git pullhochladen / herunterladen
UmfrageEine Antwort

Was würdest du mit Git zuerst versionieren?

Wird geladen …
✓ Fazit
  • Git installieren, Name und E-Mail einmalig einrichten
  • git init im Ordner, .gitignore für Sicherungskopien und Zugangsdaten
  • Alltag: git status, git diff, git add, git commit
  • Alte Stände mit git restore --source=… zurückholen
  • Experimente auf Branches, Sicherung außer Haus per git push in ein privates Repository

Gut zu wissen: Auch Restic-Backups (https://spawnpunkt.de/magazin/restic-backup-linux-server-automatisch) ersetzen Git nicht und umgekehrt. Git verfolgt bewusste Änderungen mit Beschreibung, ein Backup sichert alles automatisch.

Quellen

Kommentare

Noch keine Kommentare. Was meinst du dazu?

Mitreden? Melde dich an, um zu kommentieren.

Frage stellen

Spawnpunkt bindet keine Dienste von Drittanbietern ein. Alles, was du hier erlaubst, bleibt auf meinem eigenen Server.