n8n_node_librebooking/INSTALLATION.md

Installationsanleitung - LibreBooking n8n Node

Diese Anleitung beschreibt alle verfügbaren Methoden zur Installation des LibreBooking n8n Nodes.

Inhaltsverzeichnis

• Voraussetzungen
• Installation aus Git-Archiv
• Methode 1: Automatische Installation mit Skript
• Methode 2: Manuelle Installation mit npm
• Methode 3: Installation aus npm Registry
• Methode 4: Docker Installation
• Methode 5: n8n Community Nodes
• Verifizierung der Installation
• Troubleshooting
• Deinstallation

---

Voraussetzungen

Systemanforderungen

Komponente	Mindestversion	Empfohlen
Node.js	18.x	20.x LTS
npm	8.x	10.x
n8n	1.0.0	Neueste

Node.js installieren

Linux (Ubuntu/Debian):

# Mit NodeSource Repository (empfohlen)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Version prüfen
node --version
npm --version

macOS:

# Mit Homebrew
brew install node@20

# Version prüfen
node --version
npm --version

Windows:

1. Lade Node.js von https://nodejs.org/ herunter
2. Wähle die LTS-Version (20.x)
3. Führe den Installer aus
4. Öffne PowerShell und prüfe: node --version

n8n installieren

# Global installieren
npm install -g n8n

# Installation prüfen
n8n --version

---

Installation aus Git-Archiv

Archiv herunterladen

1. GitHub Release herunterladen:

   # .tar.gz für Linux/Mac
   wget https://github.com/DEIN-REPO/n8n-nodes-librebooking/releases/latest/download/n8n-nodes-librebooking.tar.gz
   
   # .zip für Windows
   # Über Browser herunterladen
   

2. Oder direkt von Git:

   git clone https://github.com/DEIN-REPO/n8n-nodes-librebooking.git
   cd n8n-nodes-librebooking
   

Archiv entpacken

Linux/macOS:

# .tar.gz entpacken
tar -xzf n8n-nodes-librebooking.tar.gz
cd n8n-nodes-librebooking

Windows (PowerShell):

# .zip entpacken
Expand-Archive -Path n8n-nodes-librebooking.zip -DestinationPath .
cd n8n-nodes-librebooking

---

Methode 1: Automatische Installation mit Skript

Die einfachste Methode für die meisten Benutzer.

Linux/macOS

# In das Verzeichnis wechseln
cd n8n-nodes-librebooking

# Skript ausführbar machen (falls nötig)
chmod +x install.sh

# Installation starten
./install.sh

Optionen:

./install.sh              # Standard-Installation mit npm link
./install.sh --no-link    # Nur Build, ohne npm link
./install.sh --global     # Globale Installation
./install.sh --help       # Hilfe anzeigen

Windows (PowerShell)

# In das Verzeichnis wechseln
cd n8n-nodes-librebooking

# Skript ausführen (evtl. Ausführungsrichtlinie anpassen)
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\install.ps1

Optionen:

.\install.ps1              # Standard-Installation mit npm link
.\install.ps1 -NoLink      # Nur Build, ohne npm link
.\install.ps1 -Global      # Globale Installation
.\install.ps1 -Help        # Hilfe anzeigen

---

Methode 2: Manuelle Installation mit npm

Für Benutzer, die mehr Kontrolle über den Installationsprozess möchten.

Schritt 1: Dependencies installieren

cd n8n-nodes-librebooking
npm install

Schritt 2: TypeScript kompilieren

npm run build

Schritt 3: Node verlinken

# Node global verfügbar machen
npm link

# Mit n8n verlinken (optional, falls n8n global installiert ist)
cd $(npm root -g)/n8n
npm link n8n-nodes-librebooking

Schritt 4: n8n neu starten

# n8n stoppen (falls läuft)
# Ctrl+C oder:
pkill -f n8n

# n8n starten
n8n start

---

Methode 3: Installation aus npm Registry

Hinweis: Diese Methode ist für eine zukünftige Veröffentlichung auf npm vorgesehen.

# Global installieren
npm install -g n8n-nodes-librebooking

# Oder lokal in einem Projekt
npm install n8n-nodes-librebooking

Nach der Veröffentlichung auf npm wird diese Methode die einfachste sein.

---

Methode 4: Docker Installation

Voraussetzungen für Docker

• Docker 20.x oder höher
• Docker Compose v2.x (empfohlen)

Docker installieren:

• Linux: https://docs.docker.com/engine/install/
• macOS: https://docs.docker.com/desktop/mac/install/
• Windows: https://docs.docker.com/desktop/windows/install/

Mit docker-compose (empfohlen)

cd n8n-nodes-librebooking

# Umgebungsvariablen konfigurieren (optional)
cp .env.example .env
# .env Datei bearbeiten

# Container bauen und starten
docker-compose up -d

# Logs anzeigen
docker-compose logs -f

# Status prüfen
docker-compose ps

Umgebungsvariablen (.env):

# n8n Authentifizierung
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=sicheres-passwort-hier

# Webhook-URL (für Produktion)
WEBHOOK_URL=https://n8n.deine-domain.de/

# Zeitzone
TZ=Europe/Berlin

# Log-Level (debug, info, warn, error)
N8N_LOG_LEVEL=info

Nützliche docker-compose Befehle:

# Stoppen
docker-compose down

# Neu bauen (nach Änderungen)
docker-compose build --no-cache

# Neustart
docker-compose restart

# Logs eines bestimmten Services
docker-compose logs -f n8n

# In Container Shell
docker-compose exec n8n sh

Mit Docker direkt

cd n8n-nodes-librebooking

# Image bauen
docker build -t n8n-librebooking .

# Container starten
docker run -d \
  --name n8n-librebooking \
  -p 5678:5678 \
  -e N8N_BASIC_AUTH_ACTIVE=true \
  -e N8N_BASIC_AUTH_USER=admin \
  -e N8N_BASIC_AUTH_PASSWORD=changeme \
  -e GENERIC_TIMEZONE=Europe/Berlin \
  -v n8n_data:/home/node/.n8n \
  n8n-librebooking

Container verwalten:

# Logs anzeigen
docker logs -f n8n-librebooking

# Stoppen
docker stop n8n-librebooking

# Starten
docker start n8n-librebooking

# Entfernen
docker rm -f n8n-librebooking

# Image entfernen
docker rmi n8n-librebooking

Volumes und Konfiguration

Wichtige Volumes:

Volume/Pfad	Beschreibung
/home/node/.n8n	n8n Datenverzeichnis (Workflows, Credentials)
/home/node/.n8n/custom	Custom Nodes
/home/node/workflows	Beispiel-Workflows (read-only)

Daten sichern:

# Mit docker-compose
docker-compose exec n8n tar -czf /tmp/backup.tar.gz /home/node/.n8n
docker cp n8n-librebooking:/tmp/backup.tar.gz ./backup.tar.gz

# Ohne docker-compose
docker cp n8n-librebooking:/home/node/.n8n ./n8n-backup

Daten wiederherstellen:

docker cp ./n8n-backup/. n8n-librebooking:/home/node/.n8n/
docker-compose restart

---

Methode 5: n8n Community Nodes

Hinweis: Diese Methode wird verfügbar sein, sobald der Node im n8n Community Node Repository veröffentlicht ist.

1. Öffne n8n im Browser
2. Gehe zu Settings → Community Nodes
3. Klicke auf Install a community node
4. Gib ein: n8n-nodes-librebooking
5. Klicke auf Install
6. Starte n8n neu

---

Verifizierung der Installation

1. n8n starten

# Lokal
n8n start

# Mit Docker
docker-compose up -d

2. Browser öffnen

Öffne http://localhost:5678 im Browser.

3. Node suchen

1. Erstelle einen neuen Workflow
2. Klicke auf das + Symbol
3. Suche nach "LibreBooking"
4. Du solltest zwei Nodes sehen:
   • LibreBooking (für API-Operationen)
   • LibreBooking Trigger (für Events)

4. Credentials einrichten

1. Klicke auf einen LibreBooking Node
2. Unter "Credentials" klicke auf Create New
3. Wähle LibreBooking API
4. Fülle aus:
   • URL: Deine LibreBooking URL (z.B. https://booking.example.com/Web/Services)
   • Username: Dein Admin-Benutzername
   • Password: Dein Passwort
5. Klicke auf Save
6. Teste die Verbindung

---

Troubleshooting

Häufige Probleme

Node wird nicht angezeigt

Problem: Der LibreBooking Node erscheint nicht in n8n.

Lösungen:

# 1. Prüfe, ob der Build erfolgreich war
ls -la dist/

# 2. Prüfe npm link Status
npm ls -g --depth=0 | grep librebooking

# 3. n8n Custom Extensions Pfad prüfen
echo $N8N_CUSTOM_EXTENSIONS

# 4. n8n komplett neu starten
pkill -f n8n
n8n start

Build-Fehler

Problem: npm run build schlägt fehl.

Lösungen:

# Node.js Version prüfen
node --version  # Sollte >= 18 sein

# node_modules löschen und neu installieren
rm -rf node_modules
npm install

# TypeScript-Fehler anzeigen
npx tsc --noEmit

npm link Probleme

Problem: npm link funktioniert nicht.

Lösungen:

# Als Admin/Root ausführen (Linux/Mac)
sudo npm link

# Windows: PowerShell als Administrator starten

# Alternativer Pfad für Custom Nodes
export N8N_CUSTOM_EXTENSIONS=$(pwd)
n8n start

Docker-Probleme

Problem: Container startet nicht.

Lösungen:

# Logs prüfen
docker-compose logs n8n

# Container-Status prüfen
docker-compose ps

# Neu bauen
docker-compose build --no-cache
docker-compose up -d

Credential-Fehler

Problem: "Authentication failed" bei Verbindung.

Lösungen:

1. Prüfe LibreBooking URL (inkl. /Web/Services)
2. Prüfe Benutzername und Passwort
3. Prüfe ob API in LibreBooking aktiviert ist:
   • Admin → Konfiguration → API aktivieren
4. Teste API manuell:

   curl -X POST "https://dein-server/Web/Services/Authentication/Authenticate" \
     -H "Content-Type: application/json" \
     -d '{"username":"admin","password":"password"}'
   

Logs und Debugging

n8n Logs aktivieren:

# Umgebungsvariable setzen
export N8N_LOG_LEVEL=debug
n8n start

# Mit Docker
docker-compose exec n8n sh -c "N8N_LOG_LEVEL=debug n8n start"

Node-spezifische Logs: In n8n Workflow-Ausführungen werden Details angezeigt unter "Execution Data".

---

Deinstallation

npm link entfernen

# Im Projektverzeichnis
npm unlink

# Global entfernen
npm unlink -g n8n-nodes-librebooking

Global installiertes Paket entfernen

npm uninstall -g n8n-nodes-librebooking

Docker entfernen

# Container und Volumes entfernen
docker-compose down -v

# Images entfernen
docker rmi n8n-librebooking
docker rmi n8nio/n8n

Projektverzeichnis löschen

# Verzeichnis löschen
rm -rf n8n-nodes-librebooking

# Archiv löschen
rm n8n-nodes-librebooking.tar.gz
rm n8n-nodes-librebooking.zip

---

Support

Bei Fragen oder Problemen:

1. GitHub Issues: Hier Issues erstellen
2. Dokumentation: Siehe README.md
3. LibreBooking API: https://www.bookedscheduler.com/help/api/

---

Letzte Aktualisierung: Januar 2026