69 lines
2.2 KiB
Markdown
69 lines
2.2 KiB
Markdown
# 🚀 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://<DEIN_TOKEN>@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!"
|
|
```
|