From f4b8934b610c967fd3ca0eb7c9a635e16290812f Mon Sep 17 00:00:00 2001 From: Eduard Iten Date: Tue, 10 Feb 2026 13:54:16 +0100 Subject: [PATCH] =?UTF-8?q?README=20hinzugef=C3=BCgt?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.de.md | 68 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 README.de.md diff --git a/README.de.md b/README.de.md new file mode 100644 index 0000000..666d098 --- /dev/null +++ b/README.de.md @@ -0,0 +1,68 @@ +# 🚀 Dotfiles +Dieses Repo enthält mein persönliches Terminal-Setup, optimiert für macOS und den Rock 5B. Kernstück ist die Integration der Bitwarden CLI für sichere Git-Credentials. + +## 1. Voraussetzungen (Pre-requisites) + +Bevor das Installations-Skript ausgeführt wird, müssen die Basistools vorhanden sein. +Bitwarden CLI & Tools installieren + +Auf dem Rock 5B (Debian/Ubuntu) führen wir folgende Befehle aus: +```bash +# System aktualisieren +sudo apt update && sudo apt upgrade -y + +# Abhängigkeiten installieren (jq für das Token-Parsing) +sudo apt install -y jq curl git micro + +# Bitwarden CLI installieren (via NPM oder direktes Binary) +# Empfohlener Weg via NPM: +sudo apt install -y nodejs npm +sudo npm install -g @bitwarden/cli +``` + +## 2. Bitwarden Initialisierung + +Damit der Git-Helper funktioniert, muss die CLI mit deinem Server verbunden sein. +```bash +# 1. Server-URL setzen (Beispiel Vaultwarden oder Bitwarden EU) +bw config server https://vault.bitwarden.eu + +# 2. Einloggen +bw login + +# 3. Tresor entsperren & Session setzen +# (Dafür nutzt du am besten den Alias aus dem Setup nach Schritt 3) +export BW_SESSION=$(bw unlock --raw) +``` + +## 3. Installation der Dotfiles + +Jetzt clonen wir das Repo und verknüpfen alles. Da dies der erste Zugriff ist, nutzen wir das Gitea-Token direkt in der URL: +```bash +# Repo clonen +git clone https://@gitea.iten.pro/edi/dotfiles.git ~/dotfiles + +# Installation starten +cd ~/dotfiles +bash install.sh +``` + +## Workflow: Täglicher Betrieb + +Nach der Installation ist der Ablauf auf dem Rock 5B wie folgt: + +1. Terminal öffnen. +2. ```unlock``` eingeben und Master-Passwort tippen. + * Das Schloss-Emoji 🔓 erscheint. + * Die Variable BW_SESSION ist nun aktiv. +3. Git nutzen: git push oder git pull holen sich das Passwort nun lautlos aus Bitwarden. +4. ```lock``` eingeben, um die Session zu beenden 🔒. Die Session wird auch beendet, wenn du das Terminal schliesst. + +## Ein kleiner Tipp für dein install.sh + +Damit das Skript auf dem Rock 5B nicht abbricht, kannst du am Anfang prüfen, ob die Tools da sind: +```bash +# Prüfen ob bw und jq vorhanden sind +command -v bw >/dev/null 2>&1 || echo "⚠️ Bitwarden CLI fehlt!" +command -v jq >/dev/null 2>&1 || echo "⚠️ jq fehlt!" +```