# Troubleshooting

## Inhaltsverzeichnis

1. [tsc not found](#tsc-not-found)
2. [Read-only Volume](#read-only-volume)
3. [npm audit Vulnerabilities](#npm-audit-vulnerabilities)
4. [Node nicht sichtbar](#node-nicht-sichtbar)
5. [Authentifizierung fehlgeschlagen](#authentifizierung-fehlgeschlagen)

---

## tsc not found

**Symptom:**
```
sh: 1: tsc: not found
npm error code 127
```

**Ursache:** TypeScript ist nicht installiert (im Container oft nicht verfügbar).

**Lösung:** Auf dem Host bauen!

```bash
# Auf dem Host (nicht im Container)
npm install
npm run build

# Dann in Container kopieren
docker cp dist n8n:/home/node/.n8n/custom/n8n-nodes-librebooking/
docker cp package.json n8n:/home/node/.n8n/custom/n8n-nodes-librebooking/
docker cp node_modules n8n:/home/node/.n8n/custom/n8n-nodes-librebooking/
docker restart n8n
```

**Oder mit Skript:**
```bash
./quick-install.sh n8n
```

---

## Read-only Volume

**Symptom:**
```
EROFS: read-only file system
npm error EACCES: permission denied
```

**Ursache:** Volume ist mit `:ro` gemountet.

**Lösung 1:** Volume ohne `:ro` mounten

```yaml
# docker-compose.yml
volumes:
  - ./custom-nodes:/home/node/.n8n/custom  # Ohne :ro
```

**Lösung 2:** Auf dem Host bauen und kopieren

```bash
npm install && npm run build
docker cp dist n8n:/home/node/.n8n/custom/n8n-nodes-librebooking/
```

---

## npm audit Vulnerabilities

**Symptom:**
```
found 2 vulnerabilities (1 moderate, 1 critical)
```

**Erklärung:** Diese kommen von `n8n-workflow` und sind für dieses Projekt nicht kritisch.

**Lösung:** Ignorieren oder `.npmrc` verwenden:

```bash
# .npmrc bereits konfiguriert
audit=false
```

Siehe [SECURITY.md](SECURITY.md) für Details.

---

## Node nicht sichtbar

**Lösung:**

1. Container neustarten:
   ```bash
   docker restart n8n
   ```

2. Dateien prüfen:
   ```bash
   docker exec n8n ls -la /home/node/.n8n/custom/n8n-nodes-librebooking/
   ```

3. Environment prüfen:
   ```yaml
   environment:
     - N8N_CUSTOM_EXTENSIONS=/home/node/.n8n/custom
   ```

4. Logs prüfen:
   ```bash
   docker logs n8n | grep -i librebooking
   ```

---

## Authentifizierung fehlgeschlagen

**Symptom:** "401 Unauthorized" oder "Invalid credentials"

**Lösung:**

1. URL prüfen (ohne `/Web/` am Ende)
2. Benutzer muss Admin sein
3. API muss in LibreBooking aktiviert sein

Test:
```bash
curl -X POST https://librebooking.example.com/Web/Services/Authentication/Authenticate \
  -H 'Content-Type: application/json' \
  -d '{"username": "admin", "password": "pass"}'
```

---

## Weitere Hilfe

- [README.md](README.md) - Übersicht
- [INSTALLATION.md](INSTALLATION.md) - Installationsanleitung
- [DOCKER-INTEGRATION.md](DOCKER-INTEGRATION.md) - Docker Details