Translate user-facing docs and node help to English

README, NODES.md, install scripts, palette help text, and example flows — node .js logic unchanged. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-22 17:36:38 +02:00
parent a6ff9b20e5
commit d3d3f33ec6
19 changed files with 406 additions and 566 deletions
@@ -1,23 +1,23 @@
-# Miljövariabler för install.sh / integrate-into-nodered.sh
-# Kopiera till .env och justera per VM.
+# Environment for install.sh / integrate-into-nodered.sh
+# Copy to .env and adjust per VM.

-# Nextcloud (visas i exempelflöden och dokumentation — påverkar inte själva nodkoden)
+# Nextcloud (used in example flows and install hints — does not change node code)
 NEXTCLOUD_URL=https://cloud.hannesahlin.se
 NEXTCLOUD_PUBLIC_URL=https://cloud.hannesahlin.se

-# Collabora CODE — IP detekteras automatiskt från Docker bridge om du utelämnar COLLABORA_IP
+# Collabora CODE — bridge IP auto-detected if COLLABORA_IP is empty
 CODE_CONTAINER=code
 COLLABORA_IP=
 COLLABORA_URL=

-# Befintlig Node-RED-installation (integrate-läge)
+# Existing Node-RED install (integrate mode)
 NODERED_DIR=
 NODERED_CONTAINER=nextcloud-node-red
 NODERED_PORT=1880
 INSTALL_USER=

-# Sidecar-läge (ej standard)
+# Sidecar mode (not default)
 NC_HOST=cloud.hannesahlin.se
 NC_HOST_IP=
 TZ=Europe/Stockholm
-NODERED_CREDENTIAL_SECRET=byt-den-här-hemligheten-vid-produktion
+NODERED_CREDENTIAL_SECRET=change-this-secret-in-production
@@ -1,82 +1,81 @@
 # nextcloud-collabora-nodered

-Collabora/Nextcloud Office-noder för **befintlig** `nextcloud-node-red` på port **1880**.
+Collabora / Nextcloud Office nodes for your **existing** `nextcloud-node-red` on port **1880**.

-Skapar **ingen** ny Node-RED-container.
+Does **not** create a new Node-RED container.

-## Standard: integrate (inte sidecar)
+## Default: integrate (not sidecar)

-**INSTALL_MODE=integrate** (default) patchar och bygger om befintlig `nextcloud-node-red` på **:1880**.
-Ingen ny container, ingen port 1881. Sidecar kräver uttryckligen `INSTALL_MODE=sidecar`.
+**INSTALL_MODE=integrate** (default) patches and rebuilds the existing `nextcloud-node-red` on **:1880**.
+No extra container, no port 1881. Sidecar only if you explicitly set `INSTALL_MODE=sidecar`.

-## Installation (cloud / valfri VM)
+## Quick install

 ```bash
 curl -fsSL https://kode.hannesahlin.se/n3wk/nextcloud-collabora-nodered/raw/branch/main/bootstrap-install.sh | sudo -u ncadmin bash
 ```

-Det skriptet:
-1. Klonar detta repo till `/home/ncadmin/nextcloud-collabora-nodered`
-2. Kopierar noder till `/home/ncadmin/nextcloud-node-red/nodes/nextcloud-collabora/`
-3. Patchar `Dockerfile` + `entrypoint.sh` i nextcloud-node-red
-4. Bygger om **samma** `nextcloud-node-red`-image och startar om containern
-5. Ansluter `nextcloud-node-red` till Docker `bridge` så CODE (`172.17.0.2:9980`) nås
+That script:
+1. Clones this repo
+2. Copies nodes into your `nextcloud-node-red` tree
+3. Patches `Dockerfile` + `entrypoint.sh`
+4. Rebuilds the **same** image and restarts the container
+5. Connects Node-RED to Docker `bridge` so CODE is reachable

-## Uppdatera noder
+## Update nodes

 ```bash
-cd /home/ncadmin/nextcloud-collabora-nodered
+cd /path/to/nextcloud-collabora-nodered
 git pull
 ./install.sh
 ```

-## Manuell integration
+## Manual integration

 ```bash
-cd /home/ncadmin/nextcloud-collabora-nodered
-NODERED_DIR=/home/ncadmin/nextcloud-node-red ./scripts/integrate-into-nodered.sh
+NODERED_DIR=/path/to/nextcloud-node-red ./scripts/integrate-into-nodered.sh
 ```

-## Sidecar :1881 (ej rekommenderat)
+## Sidecar :1881 (not recommended)

-Endast om du uttryckligen vill separat instans:
+Only if you explicitly want a separate instance:

 ```bash
 INSTALL_MODE=sidecar docker compose --profile sidecar up -d --build
 ```

-## Noder
+## Nodes

-Palett: **nextcloud collabora** — sex noder i samma lila, alla kopplade till **nc-collab-config** (kugghjul, inte flödesnod).
+Palette: **nextcloud collabora** — six nodes in the same purple, all wired to **nc-collab-config** (gear icon, not a flow node).

 `nc-collab-config` · `collabora-bridge` · `nc-office` · `collabora-convert` · `collabora-extract` · `collabora-transform` · `collabora-wopi`

-Full förklaring och exempel: **[docs/NODES.md](docs/NODES.md)** · importera **[flows/example-flows.json](flows/example-flows.json)**
+Full guide and examples: **[docs/NODES.md](docs/NODES.md)** · import **[flows/example-flows.json](flows/example-flows.json)**

-## Installera på valfri Nextcloud-VM
+## Install on any Nextcloud VM

-Kopiera `.env.example` → `.env` och sätt minst `NEXTCLOUD_URL`. Resten detekteras:
+Copy `.env.example` → `.env` and set at least `NEXTCLOUD_URL`. The rest is auto-detected:

-| Variabel | Default / auto |
+| Variable | Default / auto |
 |----------|----------------|
-| `NODERED_DIR` | compose-label eller `/home/ncadmin/nextcloud-node-red` |
+| `NODERED_DIR` | compose label or common paths |
 | `CODE_CONTAINER` | `code` |
-| `COLLABORA_IP` | bridge-IP via `docker inspect` |
+| `COLLABORA_IP` | bridge IP via `docker inspect` |
 | `NODERED_CONTAINER` | `nextcloud-node-red` |
 | `NODERED_PORT` | `1880` |

 ```bash
-cd /home/ncadmin/nextcloud-collabora-nodered
-cp .env.example .env   # justera NEXTCLOUD_URL per VM
+cp .env.example .env   # set NEXTCLOUD_URL for your VM
 git pull
-./install.sh           # root/sudo för docker compose
+./install.sh           # needs root/sudo for docker compose
 ```

 ## Repo

 https://kode.hannesahlin.se/n3wk/nextcloud-collabora-nodered

-## Dokumentation
+## Documentation

- [docs/AGENT-MANUAL.md](docs/AGENT-MANUAL.md)
- [docs/INFRASTRUCTURE.md](docs/INFRASTRUCTURE.md)
+- [docs/NODES.md](docs/NODES.md) — node reference and examples
+- [docs/AGENT-MANUAL.md](docs/AGENT-MANUAL.md) — flow-building guide for agents
+- [docs/INFRASTRUCTURE.md](docs/INFRASTRUCTURE.md) — server layout
@@ -1,12 +1,12 @@
 #!/usr/bin/env bash
-# bootstrap-install.sh — klona från Gitea och integrera i befintlig nextcloud-node-red
+# bootstrap-install.sh — clone from Gitea and integrate into existing nextcloud-node-red
 #
-# Skapar INTE ny Node-RED-container. Patchar /home/ncadmin/nextcloud-node-red och bygger om.
+# Does NOT create a new Node-RED container. Patches nextcloud-node-red and rebuilds.
 #
-# One-liner (kör som ncadmin, INTE root):
+# One-liner (run as install user, NOT root):
 #   curl -fsSL https://kode.hannesahlin.se/n3wk/nextcloud-collabora-nodered/raw/branch/main/bootstrap-install.sh | sudo -u ncadmin bash
 #
-# Om git "dubious ownership" (root ägde repot):
+# If git "dubious ownership" (root owned the repo):
 #   sudo bash scripts/fix-repo-ownership.sh
 #
 set -euo pipefail
@@ -34,11 +34,11 @@ SKIP_APT="${SKIP_APT:-0}"
 SKIP_DOCKER_INSTALL="${SKIP_DOCKER_INSTALL:-1}"

 log() { printf '[bootstrap] %s\n' "$*"; }
-warn() { printf '[bootstrap] VARNING: %s\n' "$*" >&2; }
-die() { printf '[bootstrap] FEL: %s\n' "$*" >&2; exit 1; }
+warn() { printf '[bootstrap] WARNING: %s\n' "$*" >&2; }
+die() { printf '[bootstrap] ERROR: %s\n' "$*" >&2; exit 1; }

 run_as_root() {
-    if [ "$(id -u)" -eq 0 ]; then "$@"; elif command -v sudo >/dev/null 2>&1; then sudo "$@"; else die "sudo krävs"; fi
+    if [ "$(id -u)" -eq 0 ]; then "$@"; elif command -v sudo >/dev/null 2>&1; then sudo "$@"; else die "sudo required"; fi
 }

 runtime_user() {
@@ -58,7 +58,7 @@ reexec_as_install_user() {
    local user
    user="$(runtime_user)"
    if [ "$(id -un)" = "root" ] && [ "${user}" != "root" ] && [ -z "${BOOTSTRAP_REEXEC:-}" ]; then
-        log "Kör om som ${user} (inte root)..."
+        log "Re-running as ${user} (not root)..."
        export BOOTSTRAP_REEXEC=1
        export INSTALL_DIR NODERED_DIR INSTALL_MODE GIT_REPO_URL GIT_BRANCH
        exec sudo -u "${user}" -H env \
@@ -80,7 +80,7 @@ fix_repo_ownership() {
    [ -d "${INSTALL_DIR}" ] || return 0
    owner="$(stat -c '%U' "${INSTALL_DIR}" 2>/dev/null || echo "")"
    if [ -n "${owner}" ] && [ "${owner}" != "${user}" ]; then
-        log "Repo ägs av ${owner} — sätter ägare ${user}:${group}"
+        log "Repo owned by ${owner} — setting owner ${user}:${group}"
        run_as_root chown -R "${user}:${group}" "${INSTALL_DIR}"
    fi
 }
@@ -98,7 +98,7 @@ ensure_git_safe_directory() {
 install_apt_packages() {
    [ "${SKIP_APT}" = "1" ] && return 0
    command -v apt-get >/dev/null 2>&1 || return 0
-    log "Installerar git, curl, rsync..."
+    log "Installing git, curl, rsync..."
    run_as_root apt-get update -qq
    run_as_root apt-get install -y -qq git curl ca-certificates rsync
 }
@@ -106,7 +106,7 @@ install_apt_packages() {
 install_docker() {
    [ "${SKIP_DOCKER_INSTALL}" = "1" ] && return 0
    command -v docker >/dev/null 2>&1 && docker info >/dev/null 2>&1 && return 0
-    log "Installerar Docker..."
+    log "Installing Docker..."
    curl -fsSL https://get.docker.com | run_as_root sh
 }

@@ -115,13 +115,13 @@ clone_or_update_repo() {
    ensure_git_safe_directory

    if [ -d "${INSTALL_DIR}/.git" ]; then
-        log "Uppdaterar ${INSTALL_DIR}..."
+        log "Updating ${INSTALL_DIR}..."
        git -C "${INSTALL_DIR}" fetch origin
        git -C "${INSTALL_DIR}" checkout "${GIT_BRANCH}"
-        git -C "${INSTALL_DIR}" pull --ff-only origin "${GIT_BRANCH}" || warn "git pull misslyckades"
+        git -C "${INSTALL_DIR}" pull --ff-only origin "${GIT_BRANCH}" || warn "git pull failed"
        return 0
    fi
-    log "Klonar ${GIT_REPO_URL} → ${INSTALL_DIR}"
+    log "Cloning ${GIT_REPO_URL} → ${INSTALL_DIR}"
    mkdir -p "$(dirname "${INSTALL_DIR}")"
    git clone --branch "${GIT_BRANCH}" --depth 1 "${GIT_REPO_URL}" "${INSTALL_DIR}"
    fix_repo_ownership
@@ -129,25 +129,25 @@ clone_or_update_repo() {
 }

 preflight() {
-    command -v docker >/dev/null 2>&1 || die "Docker saknas"
+    command -v docker >/dev/null 2>&1 || die "Docker not found"
    docker ps --format '{{.Names}}' | grep -qx "${NODERED_CONTAINER}" \
-        || die "'${NODERED_CONTAINER}' körs inte — detta skript integrerar i befintlig Node-RED, skapar ingen ny"
+        || die "'${NODERED_CONTAINER}' is not running — this script integrates into existing Node-RED, does not create a new one"
    docker ps --format '{{.Names}}' | grep -qx "${CODE_CONTAINER}" \
-        || die "'${CODE_CONTAINER}' (Collabora) körs inte"
-    [ -d "${NODERED_DIR}" ] || die "nextcloud-node-red-katalog saknas: ${NODERED_DIR}"
-    log "OK: ${NODERED_CONTAINER} + ${CODE_CONTAINER} körs"
+        || die "'${CODE_CONTAINER}' (Collabora) is not running"
+    [ -d "${NODERED_DIR}" ] || die "nextcloud-node-red directory missing: ${NODERED_DIR}"
+    log "OK: ${NODERED_CONTAINER} + ${CODE_CONTAINER} running"
 }

 main() {
    reexec_as_install_user

-    log "bootstrap v${VERSION} — läge: ${INSTALL_MODE} (befintlig Node-RED :${NODERED_PORT})"
-    log "Användare: $(id -un)"
+    log "bootstrap v${VERSION} — mode: ${INSTALL_MODE} (existing Node-RED :${NODERED_PORT})"
+    log "User: $(id -un)"
    log "Repo → ${INSTALL_DIR}"
-    log "Integrera → ${NODERED_DIR}"
+    log "Integrate → ${NODERED_DIR}"

    if [ "$(id -u)" -eq 0 ] && [ "$(runtime_user)" = "root" ]; then
-        warn "Körs som root — rekommenderat: curl ... | sudo -u ncadmin bash"
+        warn "Running as root — recommended: curl ... | sudo -u ncadmin bash"
    fi

    install_apt_packages
@@ -168,13 +168,13 @@ main() {
    cat <<EOF

 ================================================================================
-Klart — Collabora-noder i befintlig nextcloud-node-red
+Done — Collabora nodes in existing nextcloud-node-red
 ================================================================================
-Node-RED:  http://${host_ip}:${NODERED_PORT}  (samma som förut)
+Node-RED:  http://${host_ip}:${NODERED_PORT}  (same as before)
 Repo:      ${INSTALL_DIR}
-Patchad:   ${NODERED_DIR}
+Patched:   ${NODERED_DIR}

-Uppdatera senare:
+Update later:
  cd ${INSTALL_DIR} && git pull && ./install.sh

 EOF
@@ -1,205 +1,74 @@
-# Assistentmanual — Nextcloud Office + Collabora Node-RED
+# Agent manual — Nextcloud Collabora Node-RED nodes

-**Version 1.0 — 22 augusti 2026**
+For flow agents building automations on Nextcloud + Collabora CODE. You edit Node-RED flows, not LibreOffice macros in the browser. File I/O goes through WebDAV or OCS. Document conversion goes through CODE REST.

-Gäller sidecaren `nextcloud-collabora-nodered` mot Nextcloud på `cloud.hannesahlin.se` och Collabora CODE 26.04.x (container `code`, `127.0.0.1:9980`). Odds-scraper ignoreras.
+## Rules

-Du är en **flödesagent**. Du skapar och modifierar Node-RED-flöden, inte LibreOffice-makron i webbläsaren. All fil-I/O går via Nextcloud WebDAV eller OCS. All dokumentmotor går via CODE REST.
+1. Use **app passwords** in `nc-collab-config`. Never account passwords.
+2. Do **not overwrite originals**. Default output: `/Dokument/OfficeOut/`.
+3. `postMessage` and iframe APIs are browser-only — not Node-RED.
+4. Save files with **WebDAV PUT**, not WOPI PutFile.
+5. Do not expose port 9980 beyond loopback on the host.
+6. Do not touch odds-scraper or unrelated services in flows.

---
+## Environment

-## 1. Uppdrag och gränser
+| Key | Value |
+|-----|-------|
+| Nextcloud | `https://cloud.example.com` |
+| Existing Node-RED | `nextcloud-node-red` on `:1880` — Collabora nodes integrate here |
+| Internal CODE | `https://172.17.0.2:9980` on Docker bridge (container `code`) |
+| Auth | Basic + app password, header `OCS-APIRequest: true` |

-1. Använd **app-lösenord** i `nc-collab-config`. Aldrig vanligt kontolösen.
-2. Skriv **inte över original**. Standardmål: `/Dokument/OfficeOut/`.
-3. `postMessage`-API och `CallPythonScript` är iframe/webbläsare. **Inte Node-RED.**
-4. WOPI PutFile är CODE:s jobb mot Nextcloud. Agenten använder **WebDAV PUT**.
-5. Exponera inte port 9980 utanför loopback.
-6. Rör inte odds-scraper eller Gitea-databaslösen i flöden.
+See [INFRASTRUCTURE.md](INFRASTRUCTURE.md) for network layout.

---
+## Nodes

-## 2. Miljö
+Full reference: [NODES.md](NODES.md).

-| Nyckel | Värde |
-|--------|-------|
-| Nextcloud | `https://cloud.hannesahlin.se` (host 192.168.1.26) |
-| CODE | container `code`, `127.0.0.1:9980`, aliasgroup `https://cloud.hannesahlin.se:443` |
-| Befintlig Node-RED | `nextcloud-node-red` `:1880` — **Collabora-noder integreras här** |
-| Sidecar :1881 | Endast med `INSTALL_MODE=sidecar` (ej standard) |
-| Intern CODE-URL från sidecar | `http://172.17.0.2:9980` (Docker bridge, container `code`) |
-| Auth | Basic + Nextcloud app-lösenord, header `OCS-APIRequest: true` |
+**Config:** one `nc-collab-config` per environment — all six flow nodes need it.

-Se [INFRASTRUCTURE.md](INFRASTRUCTURE.md) för container- och nätverkskartor.
+**Common msg fields:** `ncPath`, `fileId`, `payload`, `format`, `destNcPath`, `fields`, `transform`, `operation`.

---
+**Prefer `collabora-bridge`** for everyday tasks (`ncFileToPdf`, `fillTemplateSave`). Use low-level `collabora-*` nodes when bridge is not enough.

-## 3. Kartan Nextcloud → Collabora
+## Example flows

-| Nextcloud | Collabora-yta | Nod |
-|-----------|-----------------|-----|
-| WebDAV GET fil | input till convert/extract/transform | convert, extract, transform, bridge |
-| WebDAV PUT | spara PDF/DOCX/PNG | samma + `destNcPath` |
-| files convert OCS | samma motor via richdocuments | nc-office `files:convert` |
-| richdocuments mallar | convert-to `template=` eller NC create-from-template | nc-office `templates:*` |
-| template fields | content controls | extractFields / fillFields / transform |
-| file versions | compare= på convert-to | bridge `compareVersionsPdf` |
-| fileId + direct token | WOPISrc + editor iframe | nc-office `document:direct`, wopi `buildEditor` |
-| assets API | linking / insert graphic URL | assets:create + klient postMessage |
-| shares | public edit URL | document:public |
-| preview | convert-to png | ncFileToPng |
-| HTML/MD | convert-to office | htmlToOffice |
-
-Talk, Tables, Mail, Collectives ska **konsumera resultatet** (dela PDF, bifoga, lägg i collective) — de ersätter inte WOPI-host.
-
---
-
-## 4. Noder och msg-kontrakt
-
-### 4.1 nc-collab-config
-
-En instans per miljö. Fält: `nextcloudUrl`, `collaboraUrl`, ev. `collaboraPublicUrl`, `username`, app-lösen, `verifyTls` (false i labb-VM tills certkedjan är ren).
-
-### 4.2 Gemensamma msg-fält
-
-| Fält | Betydelse |
-|------|-----------|
-| `ncPath` | Sökväg i användarens filrot, t.ex. `/Mallar/avtal.docx` |
-| `fileId` | Numeriskt Nextcloud-fileid |
-| `payload` | Buffer eller text om källan inte ligger i NC |
-| `format` | pdf \| png \| docx \| odt \| html \| txt \| xlsx \| pptx … |
-| `destNcPath` / `destFolder` / `destName` | Var resultatet skrivs |
-| `transform` / `fields` | JSON för struktur-API eller mallfält |
-| `templateNcPath` / `compareNcPath` | Extra filer till convert-to |
-| `operation` | Överstyr dropdown |
-| `statusCode` / `error` / `filename` / `contentType` | Utdata |
-
-### 4.3 Operationskatalog
-
-| Nod.operation | När |
-|---------------|-----|
-| bridge.ncFileToPdf/Png/Html | Standardkonvertering NC-fil → NC-fil |
-| bridge.htmlToOffice | Agentgenererad HTML/MD → office |
-| bridge.fillTemplateSave | Fyll content controls/fält och spara kopia |
-| bridge.compareVersionsPdf | Ny + gammal fil → PDF med ändringar |
-| bridge.extractToPayload | Struktur-JSON till nästa nod |
-| bridge.createAssetLink | Engångs-URL för insert i öppet dokument |
-| nc-office.templates:list\|create | Office-mallar i richdocuments |
-| nc-office.template:extractFields\|fillFields | Föredra när fileId finns |
-| nc-office.document:direct\|public | Engångs redigerings-URL |
-| nc-office.files:convert | Konvertera via Nextcloud (CODE bakom) |
-| convert + extract + transform | Låg nivå när bridge inte räcker |
-| wopi.discovery\|capabilities | Hälsokoll och mime→urlsrc |
-| wopi.buildEditor | Bygg editorUrl om token redan finns |
-| wopi.checkFileInfo\|getFile | Endast felsökning av WOPI-host |
-
---
-
-## 5. Recept
-
-### A. NC-fil till PDF
+### A. NC file → PDF

 ```
-inject {ncPath} → collabora-bridge ncFileToPdf → ev. filesharing createShare (OCS :1880)
+inject { ncPath: "/Documents/contract.docx" }
+  → collabora-bridge (ncFileToPdf)
+  → debug destNcPath
 ```

-Kontrollera `destNcPath` i svaret.
-
-### B. Avtalsmall
+### B. Template fill

 ```
-extractFields eller extract contentcontrol
-  → mappa data till fields/transform
-  → fillTemplateSave eller template:fillFields med destination
-  → valfritt ncFileToPdf
-  → document:direct för mänsklig granskning
+extractToPayload or template:extractFields
+  → function (map data to fields)
+  → fillTemplateSave or template:fillFields
 ```

-### C. Versionsdiff
+### C. Open in browser

 ```
-{ncPath: ny, compareNcPath: gammal} → compareVersionsPdf
-  → skicka PDF via Talk eller Mail-noden i OCS-paketet (:1880)
+nc-office (document:direct) → debug editorUrl
 ```

-### D. Generera dokument
+## Troubleshooting

-HTML i `payload` → `htmlToOffice` format docx eller pdf. Använd mall via convert `templateNcPath` om typografi måste följa husmall.
+| Symptom | Fix |
+|---------|-----|
+| ECONNREFUSED :9980 | Connect Node-RED to Docker bridge; use detected CODE IP |
+| Empty convert response | Use HTTPS to internal CODE; check CODE is healthy |
+| WebDAV 401 | New app password; same user as file path |
+| WebDAV 404 | Leading slash on path; URL-encode segments |

---
+## Acceptance criteria

-## 6. Vad du inte ska bygga
+- Test document converts to PDF under `/Dokument/OfficeOut/`
+- Original unchanged
+- Errors in `msg.error`, node status red — no silent failure

- En Node-RED-nod som postMessage:ar in i Collabora-iframe (kräver webbsida utanför iframen).
- Dynamisk Python mot share/Scripts/python (kräver paket på CODE och omstart).
- Andra CODE-container i compose (`code` körs redan med aliasgroup1).
- Portkrock på 1880 mot nextcloud-node-red.
-
---
-
-## 7. Felsökning
-
-| Symptom | Orsak | Åtgärd |
-|---------|-------|--------|
-| ECONNREFUSED :9980 | Sidecar inte på bridge / fel IP | Använd `http://172.17.0.2:9980`, kontrollera `docker network inspect bridge` |
-| Tomt convert-svar | CODE storage / fel URL | Anropa intern 9980, inte publik host |
-| WebDAV 401 | App-lösen / user | Nytt app-lösen, samma uid som sökvägen |
-| WebDAV 404 | Fel sökväg | Leading slash, rätt folder, URL-encode segment |
-| extract tomt | Filter / capability | capabilities, prova documentproperties |
-| WOPI 401/proof | Sessionstoken | Lämna WOPI. Använd WebDAV. |
-| TLS-fel mot NC | Cert i containern | verifyTls=false |
-
---
-
-## 8. Acceptanskriterier för ett flöde
-
- `capabilities` mot CODE returnerar JSON.
- En känd testdokumentsökväg konverteras till PDF under `/Dokument/OfficeOut/`.
- Originalfilen är oförändrad.
- Fel hamnar i `msg.error` och nodstatus röd, flödet kraschar inte tyst.
- Inga hemligheter i debug-payload till Talk.
-
---
-
-## 9. Installation (Ubuntu)
-
-```bash
-# /home/ncadmin/nextcloud-collabora-nodered
-chmod +x install.sh
-./install.sh
-# UI: http://192.168.1.26:1881
-```
-
-Överföring från Windows:
-
-```bash
-./package.sh   # skapar artifacts/nextcloud-collabora-nodered-1.0.0.tar.gz
-scp artifacts/*.tar.gz ncadmin@192.168.1.26:/home/ncadmin/
-# på servern:
-tar -xzf nextcloud-collabora-nodered-1.0.0.tar.gz -C nextcloud-collabora-nodered
-cd nextcloud-collabora-nodered && ./install.sh
-```
-
---
-
-## 10. Arkitektur
-
-```
-Befintligt (orört):
-  nextcloud-ocs 16 noder + nextcloud-config
-  container nextcloud-node-red :1880
-  CODE "code" :127.0.0.1:9980
-
-Ny yta (det här paketet):
-  nc-collab-config
-  nc-office          richdocuments OCS
-  collabora-convert  /cool/convert-to
-  collabora-extract  /cool/extract-document-structure
-  collabora-transform /cool/transform-document-structure
-  collabora-wopi     discovery, capabilities, editor-URL
-  collabora-bridge   agent-pipelines
-```
-
---
-
-*cloud.hannesahlin.se · nextcloud-collabora-nodered v1.0*
+See also [NODES.md](NODES.md) for operation tables and examples.
@@ -1,66 +1,44 @@
-# Infrastruktur — cloud.hannesahlin.se (192.168.1.26)
+# Infrastructure

-Verifierad 2026-08-22. Sidecar ska passa in utan att röra befintliga tjänster.
+Verified layout for integrate mode (nodes on existing `:1880`, not sidecar).

 ## Containers

-| Container | Image | Port | Nätverk | IP |
-|-----------|-------|------|---------|-----|
-| `code` | collabora/code:latest (26.04.3.1) | 127.0.0.1:9980 | `bridge` | 172.17.0.2 |
-| `nextcloud-node-red` | nextcloud-node-red:latest | 0.0.0.0:1880 | `nextcloud-node-red_odds_network` | 172.18.0.3 |
-| `nextcloud-node-red` | nextcloud-node-red:latest | 0.0.0.0:1880 | odds_network + **bridge** (efter install) | 172.18.0.3 |
-| ~~nextcloud-collabora-nodered~~ | — | — | **Används ej** — noder integreras i :1880 | — |
-| `gitea_server` | gitea/gitea:latest | 127.0.0.1:3000 | (egen) | — |
-| `odds-postgres` | postgres:16-alpine | 5433 | odds_network | — |
+| Container | Image | Port | Network | Notes |
+|-----------|-------|------|---------|-------|
+| nextcloud-node-red | custom | 1880 | odds_network (+ bridge for CODE) | Existing Node-RED |
+| code | collabora/code | 127.0.0.1:9980 | bridge | Collabora CODE |
+| odds-postgres | postgres:16 | 5433→5432 | odds_network | Odds scraper DB — do not touch |

-## Viktigt om nätverk
+Sidecar `nextcloud-collabora-nodered` on :1881 is **not used** — integrate mode patches the :1880 instance.

- **CODE** ligger på Docker **`bridge`** (172.17.0.0/16), inte på `odds_network`.
- **Collabora-noder** installeras i befintlig `nextcloud-node-red` — ingen ny container
- **`install.sh`** patchar `/home/ncadmin/nextcloud-node-red` och bygger om samma image
- Efter install: `docker network connect bridge nextcloud-node-red` (sker automatiskt)
- `127.0.0.1:9980` på host når CODE, men **inte** från en container utan bridge/host-mode.
- `host.docker.internal` är opålitligt på Linux — använd **172.17.0.2**.
- **nextcloud-node-red** (:1880) ska **inte** flyttas till bridge; den stannar på odds_network.
+## Networking

-## Nextcloud
+- **CODE** runs on Docker **`bridge`** (typically 172.17.0.x), not on `odds_network`.
+- After `docker compose up`, connect Node-RED to bridge:  
+  `docker network connect bridge nextcloud-node-red`
+- Host `127.0.0.1:9980` reaches CODE from the host, not from containers without bridge.
+- On Linux, prefer detected bridge IP over `host.docker.internal`.
+- **nextcloud-node-red** stays on `odds_network`; bridge is an extra attachment for CODE only.

- URL: https://cloud.hannesahlin.se
- Host: 192.168.1.26, `/var/www/nextcloud`
- Sidecar: `extra_hosts: cloud.hannesahlin.se:192.168.1.26`, `verifyTls: false` tills cert i container
-
-## CODE
-
- `aliasgroup1=https://cloud.hannesahlin.se:443`
- Starta **ingen** ny CODE-container
- REST: `/cool/convert-to`, `/cool/extract-document-structure`, `/cool/transform-document-structure`
- WOPI discovery: `/hosting/discovery`, `/hosting/capabilities`
-
-## Git (Gitea)
-
- https://kode.hannesahlin.se/n3wk/nextcloud-collabora-nodered
- SSH port **2222** på host
-
-## Bootstrap (ny VM)
-
-```bash
-curl -fsSL https://kode.hannesahlin.se/n3wk/nextcloud-collabora-nodered/raw/branch/main/bootstrap-install.sh | bash
-```
-
-## Kataloger på host
+## Install paths (example host)

 ```
 /home/ncadmin/
-├── nextcloud-node-red/          # :1880 — orört
-├── nextcloud-collabora-nodered/ # :1881 — detta paket
-├── n3wkode/                     # Gitea compose
-├── odds-scraper/                # ignoreras
-└── nodered-embed/
+├── nextcloud-node-red/              # :1880 — patched by integrate
+│   └── nodes/nextcloud-collabora/   # copied package (lib/ + nodes/)
+└── nextcloud-collabora-nodered/     # this repo
 ```

-## Collabora SDK (referens)
+## Public vs internal URLs

- [Conversion API](https://sdk.collaboraonline.com/docs/conversion_api.html)
- [Extract/Transform API](https://sdk.collaboraonline.com/docs/extract_transform_api.html)
- [Linking API](https://sdk.collaboraonline.com/docs/linking_api.html)
- postMessage: webbläsare/iframe — **inte** Node-RED
+| Use | URL |
+|-----|-----|
+| Nextcloud API / WebDAV | `https://cloud.example.com` |
+| CODE from Node-RED container | `https://<bridge-ip>:9980` (verifyTls=false) |
+| Browser editor / WOPI | `collaboraPublicUrl` — usually same as Nextcloud proxy |
+
+## Gitea (optional)
+
+- https://kode.hannesahlin.se/n3wk/nextcloud-collabora-nodered
+- SSH git on port 2222 if configured
@@ -1,71 +1,71 @@
-# Noder — nextcloud collabora
+# Nodes — nextcloud collabora

-Sex flödesnoder i paletten + en config. Alla sex pekar på samma **nc-collab-config** (kugghjul, inte i paletten). Utan config händer inget.
+Six flow nodes in the palette plus one config node. All six point at the same **nc-collab-config** (gear menu, not in the palette). Without config, nothing works.

 ## Backends

-| Backend | Typisk adress | Roll |
-|---------|---------------|------|
-| Nextcloud | `https://cloud.hannesahlin.se` | Filer (WebDAV) + Office-API (OCS) |
-| Collabora CODE | `https://172.17.0.2:9980` | Konvertering (`/cool/...`) på Docker bridge |
+| Backend | Typical URL | Role |
+|---------|-------------|------|
+| Nextcloud | `https://cloud.example.com` | Files (WebDAV) + Office API (OCS) |
+| Collabora CODE | `https://172.17.0.2:9980` | Conversion (`/cool/...`) on Docker bridge |

-Auth: **användarnamn + app-lösenord**. Inte kontolösen.
+Auth: **username + app password**. Not your account password.

-Standardutdata om du inte anger sökväg: `/Dokument/OfficeOut/`
+Default output folder if you omit a path: `/Dokument/OfficeOut/` (or set your own via `destNcPath`).

 ---

-## Så hänger de ihop
+## How they fit together

 ```
-nc-collab-config (URL + app-lösen)
+nc-collab-config (URLs + app password)
        │
   ┌────┼────┬────────────┐
   ▼    ▼    ▼            ▼
 collabora-*  nc-office  collabora-wopi  collabora-bridge
-(direkt CODE) (NC OCS)  (health/WOPI)   (kedjor + sparar)
+(direct CODE) (NC OCS)  (health/WOPI)   (pipelines + save)
 ```

-**Tumregel**
+**Rules of thumb**

- PDF i Nextcloud → `collabora-bridge` **ncFileToPdf**
- Fylla mall i NC → **fillTemplateSave** eller `nc-office template:fillFields`
- Öppna i webbläsaren → `nc-office` **document:direct**
- Bara byta format i minnet → `collabora-convert`
- Se fältnamn → `collabora-extract` eller bridge **extractToPayload**
- Kolla att CODE lever → `collabora-wopi` **capabilities**
+- PDF in Nextcloud → `collabora-bridge` **ncFileToPdf**
+- Fill template in NC → **fillTemplateSave** or `nc-office template:fillFields`
+- Open in browser → `nc-office` **document:direct**
+- Convert in memory only → `collabora-convert`
+- List field names → `collabora-extract` or bridge **extractToPayload**
+- Check CODE is alive → `collabora-wopi` **capabilities**

 ---

-## Gemensamma fält i msg
+## Common `msg` fields

-| Fält | Betydelse |
-|------|-----------|
-| `ncPath` | Sökväg i användarens filer, t.ex. `/Dokument/avtal.docx` |
-| `fileId` | NC fil-id (slås upp från ncPath om saknas) |
-| `payload` | Rådata redan i flödet (Buffer eller HTML) |
+| Field | Meaning |
+|-------|---------|
+| `ncPath` | Path in the user's files, e.g. `/Documents/contract.docx` |
+| `fileId` | Nextcloud numeric file id (resolved from `ncPath` if missing) |
+| `payload` | Raw data already in the flow (Buffer or HTML string) |
 | `format` | pdf, png, docx, html, … |
-| `destNcPath` | Exakt målsökväg |
-| `destFolder` / `destName` | Mapp + namn (default `/Dokument/OfficeOut/`) |
-| `fields` / `transform` | JSON att skriva in i mall |
-| `templateNcPath` | Extra mall till convert |
-| `compareNcPath` | Gammal version för diff-PDF |
-| `operation` | Överstyr dropdown på noden |
+| `destNcPath` | Exact destination path |
+| `destFolder` / `destName` | Folder + name (default folder `/Dokument/OfficeOut/`) |
+| `fields` / `transform` | JSON to merge into a template |
+| `templateNcPath` | Extra template file for convert |
+| `compareNcPath` | Older version for diff PDF |
+| `operation` | Overrides the node dropdown |

-Fel → `msg.error` + röd nod. Flödet dör inte tyst.
+Errors go to `msg.error` and turn the node red. The flow does not fail silently.

 ---

 ## 1. collabora-convert

-Gör om fil till annat format via CODE. Sparar **inte** i Nextcloud — utdata i `msg.payload` (Buffer).
+Convert a file to another format via CODE. Does **not** save to Nextcloud — output is `msg.payload` (Buffer).

-**In:** `msg.payload` eller WebDAV GET `msg.ncPath`. Valfritt `templateNcPath`, `compareNcPath`, `format`.
+**In:** `msg.payload` or WebDAV GET `msg.ncPath`. Optional `templateNcPath`, `compareNcPath`, `format`.

-**Ut:** `payload`, `filename`, `format`, `contentType`, `statusCode`.
+**Out:** `payload`, `filename`, `format`, `contentType`, `statusCode`.

 ```
-inject { ncPath: "/Dokument/avtal.docx", format: "pdf" }
+inject { ncPath: "/Documents/contract.docx", format: "pdf" }
  → collabora-convert → debug
 ```

@@ -73,12 +73,12 @@ inject { ncPath: "/Dokument/avtal.docx", format: "pdf" }

 ## 2. collabora-extract

-Lista struktur (content controls, fält …). JSON ut, ingen fil.
+List structure inside a document (content controls, fields, etc.). JSON out, no file.

-**In:** samma källa som convert. Filter: nod eller `msg.filter` (default `contentcontrol`).
+**In:** same as convert. Filter: node dropdown or `msg.filter` (default `contentcontrol`).

 ```
-inject { ncPath: "/Mallar/avtal.docx" }
+inject { ncPath: "/Templates/contract.docx" }
  → collabora-extract → function → collabora-transform
 ```

@@ -86,50 +86,50 @@ inject { ncPath: "/Mallar/avtal.docx" }

 ## 3. collabora-transform

-Skriv värden i dokument via CODE. Kräver `msg.fields` eller `msg.transform`.
+Write values into a document via CODE. Requires `msg.fields` or `msg.transform`.

 ```
-msg.ncPath = "/Mallar/avtal.docx"
-msg.fields = { "Kund": "AB Exempel", "Datum": "2026-08-22" }
+msg.ncPath = "/Templates/contract.docx"
+msg.fields = { "Customer": "ACME Ltd", "Date": "2026-08-22" }
  → collabora-transform
 ```

-Spara själv efteråt om filen ska ligga i NC.
+Save yourself afterwards if the file should live in Nextcloud.

 ---

 ## 4. collabora-wopi

-Hälsokoll och WOPI — inte konvertering.
+Health checks and WOPI helpers — not conversion.

-| Operation | Syfte |
-|-----------|--------|
-| `capabilities` | Första test att CODE svarar |
-| `discovery` | mime → editor-URL |
+| Operation | Purpose |
+|-----------|---------|
+| `capabilities` | First test that CODE responds |
+| `discovery` | mime → editor URL |
 | `buildEditor` | `wopiSrc` + `token` → `editorUrl` |
-| `checkFileInfo` / `getFile` | Felsökning |
+| `checkFileInfo` / `getFile` | Debugging |

-Publik editor-URL går via Nextcloud (`collaboraPublicUrl`), inte intern IP.
+Public editor URLs go through Nextcloud (`collaboraPublicUrl`), not the internal CODE IP.

 ---

 ## 5. nc-office

-Nextcloud richdocuments OCS — mallar, fält, editor-URL, assets.
+Nextcloud richdocuments OCS — templates, fields, editor URL, assets.

-| Operation | Kort |
-|-----------|------|
-| `templates:list` | Lista mallar |
-| `templates:create` | Ny fil från mall |
-| `template:extractFields` | Fält-JSON via NC |
-| `template:fillFields` | Fyll + spara i NC |
-| `document:direct` | `editorUrl` för inloggad användare |
-| `document:public` | Samma med shareToken |
-| `files:convert` | NC → NC konvertering |
-| `assets:create` | Infogningslänk till öppen editor |
+| Operation | Summary |
+|-----------|---------|
+| `templates:list` | List templates |
+| `templates:create` | New file from template |
+| `template:extractFields` | Field JSON via NC |
+| `template:fillFields` | Fill + save in NC |
+| `document:direct` | `editorUrl` for logged-in user |
+| `document:public` | Same with `shareToken` |
+| `files:convert` | NC → NC conversion |
+| `assets:create` | One-shot insert URL for open editor |

 ```
-inject { ncPath: "/Dokument/avtal.docx" }
+inject { ncPath: "/Documents/contract.docx" }
  → nc-office (document:direct) → debug editorUrl
 ```

@@ -137,38 +137,38 @@ inject { ncPath: "/Dokument/avtal.docx" }

 ## 6. collabora-bridge

-Färdiga pipelines — det mesta i vardagsflöden.
+Ready-made pipelines — what you'll use most day to day.

-| Operation | Gör |
-|-----------|-----|
-| `ncFileToPdf` | NC-fil → PDF i OfficeOut |
-| `ncFileToPng` | Förhandsvisning |
-| `ncFileToHtml` | HTML-export |
+| Operation | Does |
+|-----------|------|
+| `ncFileToPdf` | NC file → PDF in OfficeOut |
+| `ncFileToPng` | Preview PNG |
+| `ncFileToHtml` | HTML export |
 | `htmlToOffice` | HTML → docx/pdf … |
-| `fillTemplateSave` | Mall + fält → spara i NC |
-| `compareVersionsPdf` | Diff-PDF |
-| `extractToPayload` | Fält-JSON i msg |
-| `createAssetLink` | assetUrl |
+| `fillTemplateSave` | Template + fields → save in NC |
+| `compareVersionsPdf` | Diff PDF |
+| `extractToPayload` | Field JSON in msg |
+| `createAssetLink` | `assetUrl` |

 ```
-inject { ncPath: "/Dokument/avtal.docx" }
+inject { ncPath: "/Documents/contract.docx" }
  → collabora-bridge (ncFileToPdf)
  → debug destNcPath
 ```

-Efter bridge kan du koppla dina befintliga OCS-noder (Talk, Mail, dela länk): först PDF i `/Dokument/OfficeOut/`, sedan dela.
+Chain your existing OCS nodes (Talk, Mail, share link) after bridge: PDF lands in `/Dokument/OfficeOut/`, then share or send.

 ---

 ## Config: nc-collab-config

-Skapas under kugghjul i Node-RED. Alla sex noder väljer samma config-instans.
+Create under the gear icon in Node-RED. All six flow nodes pick the same config instance.

-| Fält | Exempel |
-|------|---------|
-| nextcloudUrl | `https://cloud.hannesahlin.se` |
-| collaboraUrl | `https://172.17.0.2:9980` (bridge-IP, verifyTls=false) |
-| collaboraPublicUrl | `https://cloud.hannesahlin.se` |
-| username + app-lösenord | Nextcloud-inloggning |
+| Field | Example |
+|-------|---------|
+| nextcloudUrl | `https://cloud.example.com` |
+| collaboraUrl | `https://172.17.0.2:9980` (bridge IP, verifyTls=false) |
+| collaboraPublicUrl | `https://cloud.example.com` |
+| username + app password | Nextcloud login |

-IP för CODE detekteras vid `./install.sh` — se `.env.example`.
+CODE IP is detected when you run `./install.sh` — see `.env.example`.
@@ -2,9 +2,9 @@
    {
        "id": "collab_tab",
        "type": "tab",
-        "label": "NC Collabora — exempel",
+        "label": "NC Collabora — examples",
        "disabled": false,
-        "info": "Skapa nc-collab-config först (kugghjul). Byt FILL_IN_USER och app-lösenord.\n\n1. capabilities — CODE lever?\n2. ncFileToPdf — PDF i OfficeOut\n3. document:direct — editorUrl\n\nSe docs/NODES.md"
+        "info": "Create nc-collab-config first (gear menu). Set FILL_IN_USER and app password.\n\n1. capabilities — is CODE up?\n2. ncFileToPdf — PDF in OfficeOut\n3. document:direct — editorUrl\n\nSee docs/NODES.md"
    },
    {
        "id": "nc_collab_cfg",
@@ -104,7 +104,7 @@
        "id": "inj_editor",
        "type": "inject",
        "z": "collab_tab",
-        "name": "3. Öppna i Office",
+        "name": "3. Open in Office",
        "props": [
            {
                "p": "ncPath",
@@ -149,7 +149,7 @@
        "id": "inj_extract",
        "type": "inject",
        "z": "collab_tab",
-        "name": "4. Fält i mall",
+        "name": "4. Template fields",
        "props": [
            {
                "p": "ncPath",
@@ -1,17 +1,17 @@
 #!/usr/bin/env bash
-# install.sh — integrera Collabora-noder i befintlig nextcloud-node-red (:1880)
+# install.sh — integrate Collabora nodes into existing nextcloud-node-red (:1880)
 #
-# Standard: INSTALL_MODE=integrate (ingen ny container, ingen port 1881)
-# Sidecar (endast om du uttryckligen vill): INSTALL_MODE=sidecar
+# Default: INSTALL_MODE=integrate (no new container, no port 1881)
+# Sidecar (only if you explicitly want it): INSTALL_MODE=sidecar
 #
-# Miljövariabler (valfria — .env i reporoten laddas automatiskt):
-#   NODERED_DIR          Sökväg till befintlig nextcloud-node-red (auto-detekteras om tom)
-#   NODERED_CONTAINER    Docker-namn, default nextcloud-node-red
+# Environment (optional — .env in repo root is loaded automatically):
+#   NODERED_DIR          Path to existing nextcloud-node-red (auto-detected if empty)
+#   NODERED_CONTAINER    Docker name, default nextcloud-node-red
 #   NODERED_PORT         default 1880
-#   CODE_CONTAINER       Docker-namn för Collabora CODE, default code
-#   COLLABORA_IP         CODE:s bridge-IP (auto-detekteras om tom)
-#   NEXTCLOUD_URL        t.ex. https://cloud.hannesahlin.se (hints i slutet)
-#   INSTALL_USER         filägare vid chown, default ncadmin
+#   CODE_CONTAINER       Collabora CODE container name, default code
+#   COLLABORA_IP         CODE bridge IP (auto-detected if empty)
+#   NEXTCLOUD_URL        e.g. https://cloud.example.com (shown in install summary)
+#   INSTALL_USER         file owner for chown, default ncadmin
 #   FORCE_REBUILD=1      docker compose build --no-cache
 #
 set -euo pipefail
@@ -21,7 +21,7 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 INSTALL_DIR="${INSTALL_DIR:-$SCRIPT_DIR}"
 INSTALL_MODE="${INSTALL_MODE:-integrate}"

-# Ladda .env om den finns (inga hemligheter krävs här)
+# Load .env if present (no secrets required here)
 if [ -f "${INSTALL_DIR}/.env" ]; then
    set -a
    # shellcheck disable=SC1091
@@ -39,25 +39,25 @@ NEXTCLOUD_URL="${NEXTCLOUD_URL:-https://cloud.hannesahlin.se}"
 [ -n "${NEXTCLOUD_URL}" ] || NEXTCLOUD_URL="https://cloud.hannesahlin.se"

 log() { printf '[install] %s\n' "$*"; }
-die() { printf '[install] FEL: %s\n' "$*" >&2; exit 1; }
+die() { printf '[install] ERROR: %s\n' "$*" >&2; exit 1; }

-log "nextcloud-collabora-nodered v${VERSION} (läge: ${INSTALL_MODE})"
+log "nextcloud-collabora-nodered v${VERSION} (mode: ${INSTALL_MODE})"

 if [ "${INSTALL_MODE}" = "sidecar" ]; then
-    log "Sidecar-läge — varning: standard är integrate (befintlig :1880)"
-    require_cmd() { command -v "$1" >/dev/null 2>&1 || die "Saknar: $1"; }
+    log "Sidecar mode — note: default is integrate (existing :1880)"
+    require_cmd() { command -v "$1" >/dev/null 2>&1 || die "Missing: $1"; }
    require_cmd docker
    COMPOSE="docker compose"
    docker compose version >/dev/null 2>&1 || COMPOSE="docker-compose"
    cd "${INSTALL_DIR}"
-    [ -f docker-compose.yml ] || die "docker-compose.yml saknas"
+    [ -f docker-compose.yml ] || die "docker-compose.yml not found"
    [ -f .env ] || cp .env.example .env
    if ! docker ps --format '{{.Names}}' | grep -qx "${CODE_CONTAINER}"; then
-        die "CODE-container '${CODE_CONTAINER}' körs inte"
+        die "CODE container '${CODE_CONTAINER}' is not running"
    fi
    ${COMPOSE} build
    ${COMPOSE} up -d
-    log "Sidecar startad på :1881 (ej rekommenderat om :1880 redan kör)"
+    log "Sidecar started on :1881 (not recommended if :1880 already runs)"
    exit 0
 fi

@@ -73,4 +73,4 @@ PKG_SRC="${INSTALL_DIR}" \
    INSTALL_USER="${INSTALL_USER:-}" \
    bash "${SCRIPT_DIR}/scripts/integrate-into-nodered.sh"

-log "Klart."
+log "Done."
@@ -18,7 +18,7 @@

 <script type="text/html" data-template-name="collabora-bridge">
    <div class="form-row">
-        <label for="node-input-name"><i class="fa fa-tag"></i> Namn</label>
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
        <input type="text" id="node-input-name">
    </div>
    <div class="form-row">
@@ -41,27 +41,27 @@
 </script>

 <script type="text/html" data-help-name="collabora-bridge">
-    <p><strong>Färdiga pipelines.</strong> Kedjar WebDAV + CODE + (ibland) OCS och skriver oftast tillbaka till Nextcloud. Det här är noden du når efter oftast.</p>
-    <p>Defaultmål: <code>/Dokument/OfficeOut/</code> om du inte sätter <code>destNcPath</code> / <code>destFolder</code> / <code>destName</code>.</p>
+    <p><strong>Ready-made pipelines.</strong> Chains WebDAV + CODE + (sometimes) OCS and usually writes back to Nextcloud. This is the node you'll reach for most often.</p>
+    <p>Default destination: <code>/Dokument/OfficeOut/</code> unless you set <code>destNcPath</code> / <code>destFolder</code> / <code>destName</code>.</p>

    <table style="width:100%; font-size:11px;">
-        <tr><th>Operation</th><th>Resultat</th></tr>
-        <tr><td><code>ncFileToPdf</code></td><td>PDF i NC</td></tr>
-        <tr><td><code>ncFileToPng</code></td><td>Förhandsvisning PNG</td></tr>
-        <tr><td><code>ncFileToHtml</code></td><td>HTML i NC</td></tr>
-        <tr><td><code>htmlToOffice</code></td><td>HTML/text → docx/pdf …</td></tr>
-        <tr><td><code>fillTemplateSave</code></td><td>Fyll mall via OCS, spara i NC</td></tr>
-        <tr><td><code>compareVersionsPdf</code></td><td>Diff-PDF (ny + <code>compareNcPath</code>)</td></tr>
-        <tr><td><code>extractToPayload</code></td><td>JSON i <code>msg.fields</code> / <code>msg.structure</code></td></tr>
-        <tr><td><code>createAssetLink</code></td><td><code>msg.assetUrl</code> för infogning</td></tr>
+        <tr><th>Operation</th><th>Result</th></tr>
+        <tr><td><code>ncFileToPdf</code></td><td>PDF saved in NC</td></tr>
+        <tr><td><code>ncFileToPng</code></td><td>Preview PNG</td></tr>
+        <tr><td><code>ncFileToHtml</code></td><td>HTML in NC</td></tr>
+        <tr><td><code>htmlToOffice</code></td><td>HTML → docx/pdf …</td></tr>
+        <tr><td><code>fillTemplateSave</code></td><td>Fill template via OCS, save in NC</td></tr>
+        <tr><td><code>compareVersionsPdf</code></td><td>Diff PDF (new + <code>compareNcPath</code>)</td></tr>
+        <tr><td><code>extractToPayload</code></td><td>Field JSON in msg</td></tr>
+        <tr><td><code>createAssetLink</code></td><td><code>msg.assetUrl</code> for insert</td></tr>
    </table>

-    <p>Överstyr via <code>msg.operation</code>. Skriver inte över original utan <code>msg.allowOverwrite=true</code>.</p>
-    <p>De andra noderna i paletten är byggstenar när bridge inte räcker.</p>
+    <p>Override via <code>msg.operation</code>. Does not overwrite originals unless <code>msg.allowOverwrite=true</code>.</p>
+    <p>The other palette nodes are building blocks when bridge isn't enough.</p>

-    <pre>inject { ncPath: "/Dokument/avtal.docx" }
+    <pre>inject { ncPath: "/Documents/contract.docx" }
  → collabora-bridge (ncFileToPdf)
-  → debug { destNcPath: "/Dokument/OfficeOut/avtal.pdf" }</pre>
+  → debug { destNcPath: "/Dokument/OfficeOut/contract.pdf" }</pre>

-    <p><strong>Tumregel:</strong> PDF i Nextcloud → <code>ncFileToPdf</code>. Mall + spara → <code>fillTemplateSave</code>. Öppna i webbläsare → <code>nc-office document:direct</code>.</p>
+    <p><strong>Rule of thumb:</strong> PDF in Nextcloud → <code>ncFileToPdf</code>. Fill template → <code>fillTemplateSave</code>. Open in browser → <code>nc-office document:direct</code>.</p>
 </script>
@@ -19,7 +19,7 @@

 <script type="text/html" data-template-name="collabora-convert">
    <div class="form-row">
-        <label for="node-input-name"><i class="fa fa-tag"></i> Namn</label>
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
        <input type="text" id="node-input-name">
    </div>
    <div class="form-row">
@@ -42,26 +42,24 @@
 </script>

 <script type="text/html" data-help-name="collabora-convert">
-    <p><strong>Gör om filen till annat format.</strong> Skickar dokument till CODE och får tillbaka binär data (pdf, png, docx, odt, html, xlsx, pptx …). Sparar inte i Nextcloud — resultatet ligger i <code>msg.payload</code> som Buffer.</p>
+    <p><strong>Convert a file to another format.</strong> Sends a document to CODE and returns binary data (pdf, png, docx, odt, html, xlsx, pptx …). Does not save to Nextcloud — result is <code>msg.payload</code> as a Buffer.</p>

-    <h4>Varifrån</h4>
-    <p>Filinnehåll, i ordning:</p>
+    <h4>Input</h4>
+    <p>File content, in order:</p>
    <ol>
-        <li><code>msg.payload</code> om det redan är Buffer/text</li>
-        <li>annars WebDAV GET av <code>msg.ncPath</code></li>
+        <li><code>msg.payload</code> if it's already a Buffer or text</li>
+        <li>otherwise WebDAV GET of <code>msg.ncPath</code></li>
    </ol>
-    <p>Valfritt: <code>msg.templateNcPath</code> (mall), <code>msg.compareNcPath</code> (jämförelsefil).</p>
+    <p>Optional: <code>msg.templateNcPath</code> (template), <code>msg.compareNcPath</code> (compare file).</p>

-    <h4>Vart</h4>
-    <p>POST multipart → <code>/cool/convert-to/&lt;format&gt;</code> på CODE. Fält: <code>data</code> = källfilen.</p>
-
-    <h4>Ut</h4>
+    <h4>Output</h4>
+    <p>POST multipart to CODE <code>/cool/convert-to/&lt;format&gt;</code>. Field: <code>data</code> = source file.</p>
    <p><code>msg.payload</code>, <code>msg.filename</code>, <code>msg.format</code>, <code>msg.contentType</code>, <code>msg.statusCode</code></p>

-    <h4>När</h4>
-    <p>När du själv styr nästa steg: spara med WebDAV/OCS, mejla, Talk, eller skicka vidare. Vill du ha PDF i Nextcloud direkt — använd <code>collabora-bridge</code> (<code>ncFileToPdf</code>).</p>
+    <h4>When to use</h4>
+    <p>When you control the next step: save via WebDAV/OCS, email, Talk, or pass on in the flow. For "file in NC → PDF in NC" use <code>collabora-bridge</code> (<code>ncFileToPdf</code>).</p>

-    <pre>inject { ncPath: "/Dokument/avtal.docx", format: "pdf" }
+    <pre>inject { ncPath: "/Documents/contract.docx", format: "pdf" }
  → collabora-convert
-  → debug (payload = PDF-bytes)</pre>
+  → debug (payload = PDF bytes)</pre>
 </script>
@@ -18,7 +18,7 @@

 <script type="text/html" data-template-name="collabora-extract">
    <div class="form-row">
-        <label for="node-input-name"><i class="fa fa-tag"></i> Namn</label>
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
        <input type="text" id="node-input-name">
    </div>
    <div class="form-row">
@@ -32,23 +32,21 @@
 </script>

 <script type="text/html" data-help-name="collabora-extract">
-    <p><strong>Lista vad som finns i dokumentet.</strong> Content controls, fält, ev. annan struktur beroende på filter. Returnerar JSON — ingen ny fil.</p>
+    <p><strong>List what's inside a document.</strong> Content controls, fields, or other structure depending on filter. Returns JSON — no new file.</p>

-    <h4>Varifrån</h4>
-    <p>Samma som convert: <code>msg.payload</code> eller WebDAV GET <code>msg.ncPath</code>.</p>
-    <p>Filter: dropdown eller <code>msg.filter</code>. Default <code>contentcontrol</code>.</p>
+    <h4>Input</h4>
+    <p>Same as convert: <code>msg.payload</code> or WebDAV GET <code>msg.ncPath</code>.</p>
+    <p>Filter: dropdown or <code>msg.filter</code>. Default <code>contentcontrol</code>.</p>

-    <h4>Vart</h4>
-    <p>POST multipart → <code>/cool/extract-document-structure</code></p>
+    <h4>Output</h4>
+    <p>POST multipart to <code>/cool/extract-document-structure</code></p>
+    <p><code>msg.payload</code> and <code>msg.structure</code> = structure JSON</p>

-    <h4>Ut</h4>
-    <p><code>msg.payload</code> och <code>msg.structure</code> = struktur-JSON</p>
+    <h4>When to use</h4>
+    <p>Before filling a template. You get field names (Customer, Date …) for the next node.</p>

-    <h4>När</h4>
-    <p>Innan du fyller en mall. Du får fältnamnen (Kund, Datum …) så nästa nod vet vad den ska slå in.</p>
-
-    <pre>inject { ncPath: "/Mallar/avtal.docx" }
+    <pre>inject { ncPath: "/Templates/contract.docx" }
  → collabora-extract (filter: contentcontrol)
-  → function (mappa data till fältnamn)
+  → function (map your data to field names)
  → collabora-transform / nc-office / bridge fillTemplateSave</pre>
 </script>
@@ -17,7 +17,7 @@

 <script type="text/html" data-template-name="collabora-transform">
    <div class="form-row">
-        <label for="node-input-name"><i class="fa fa-tag"></i> Namn</label>
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
        <input type="text" id="node-input-name">
    </div>
    <div class="form-row">
@@ -27,25 +27,23 @@
 </script>

 <script type="text/html" data-help-name="collabora-transform">
-    <p><strong>Skriv in värden i dokumentet.</strong> Tar dokument + JSON med fält/transform och ber CODE fylla i. Resultat = ny dokument-binär, inte JSON.</p>
+    <p><strong>Write values into a document.</strong> Takes document + JSON fields/transform and asks CODE to fill them in. Result is a new document binary, not JSON.</p>

-    <h4>Varifrån</h4>
+    <h4>Input</h4>
    <ul>
-        <li>Dokument: <code>msg.payload</code> eller <code>msg.ncPath</code> (WebDAV)</li>
-        <li>Instruktion: <code>msg.transform</code> eller <code>msg.fields</code> — måste finnas</li>
+        <li>Document: <code>msg.payload</code> or <code>msg.ncPath</code> (WebDAV)</li>
+        <li>Instruction: <code>msg.transform</code> or <code>msg.fields</code> — required</li>
    </ul>

-    <h4>Vart</h4>
-    <p>POST multipart → <code>/cool/transform-document-structure</code>. Fält: <code>data</code> = filen, <code>transform</code> = JSON.</p>
+    <h4>Output</h4>
+    <p>POST multipart to <code>/cool/transform-document-structure</code>. Fields: <code>data</code> = file, <code>transform</code> = JSON.</p>
+    <p><code>msg.payload</code> = modified file (Buffer), plus <code>contentType</code></p>

-    <h4>Ut</h4>
-    <p><code>msg.payload</code> = ändrad fil (Buffer), plus <code>contentType</code></p>
+    <h4>When to use</h4>
+    <p>Fill a template via CODE directly, not Nextcloud's template API. Save yourself afterwards (WebDAV PUT / bridge / nc-office) if the file should live in the cloud.</p>

-    <h4>När</h4>
-    <p>Fylla mall via CODE direkt, inte Nextclouds mall-API. Spara själv efteråt (WebDAV PUT / bridge / nc-office) om filen ska ligga i molnet.</p>
-
-    <pre>msg.ncPath = "/Mallar/avtal.docx"
-msg.fields = { "Kund": "AB Exempel", "Datum": "2026-08-22" }
+    <pre>msg.ncPath = "/Templates/contract.docx"
+msg.fields = { "Customer": "ACME Ltd", "Date": "2026-08-22" }
  → collabora-transform
-  → (spara eller konvertera till PDF)</pre>
+  → (save or convert to PDF)</pre>
 </script>
@@ -18,7 +18,7 @@

 <script type="text/html" data-template-name="collabora-wopi">
    <div class="form-row">
-        <label for="node-input-name"><i class="fa fa-tag"></i> Namn</label>
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
        <input type="text" id="node-input-name">
    </div>
    <div class="form-row">
@@ -38,26 +38,26 @@
 </script>

 <script type="text/html" data-help-name="collabora-wopi">
-    <p>Inte filkonvertering — hälsokoll och WOPI-hjälp mot CODE.</p>
+    <p>Not file conversion — health checks and WOPI helpers against CODE.</p>

    <table style="width:100%; font-size:12px;">
-        <tr><th>Operation</th><th>Du får</th></tr>
-        <tr><td><code>capabilities</code></td><td>JSON: vad CODE kan (convert-to m.m.)</td></tr>
-        <tr><td><code>discovery</code></td><td>XML: mime → editor-URL</td></tr>
-        <tr><td><code>buildEditor</code></td><td><code>msg.editorUrl</code> från <code>msg.wopiSrc</code> + <code>msg.token</code></td></tr>
-        <tr><td><code>checkFileInfo</code></td><td>JSON om filen (WOPI-host, oftast Nextcloud)</td></tr>
-        <tr><td><code>getFile</code></td><td>filbytes via WOPI GET</td></tr>
+        <tr><th>Operation</th><th>You get</th></tr>
+        <tr><td><code>capabilities</code></td><td>JSON: what CODE supports (convert-to, etc.)</td></tr>
+        <tr><td><code>discovery</code></td><td>XML: mime → editor URL</td></tr>
+        <tr><td><code>buildEditor</code></td><td><code>msg.editorUrl</code> from <code>msg.wopiSrc</code> + <code>msg.token</code></td></tr>
+        <tr><td><code>checkFileInfo</code></td><td>JSON about the file (WOPI host, usually Nextcloud)</td></tr>
+        <tr><td><code>getFile</code></td><td>file bytes via WOPI GET</td></tr>
    </table>

-    <p><code>buildEditor</code> sätter ungefär:<br>
+    <p><code>buildEditor</code> builds roughly:<br>
    <code>{collaboraPublicUrl}/browser/dist/cool.html?WOPISrc=...&amp;access_token=...</code><br>
-    Publik URL = Nextcloud/proxy (<code>https://cloud.hannesahlin.se</code>), inte intern CODE-IP.</p>
+    Public URL = Nextcloud/proxy, not internal CODE IP.</p>

-    <h4>När</h4>
+    <h4>When to use</h4>
    <ul>
-        <li>Första test att CODE lever → <code>capabilities</code></li>
-        <li>WOPI-token från <code>nc-office document:direct</code> → bygg iframe-URL</li>
-        <li>Felsökning. Spara filer via WebDAV, inte WOPI PutFile.</li>
+        <li>First test that CODE is up → <code>capabilities</code></li>
+        <li>WOPI token from <code>nc-office document:direct</code> → build iframe URL</li>
+        <li>Debugging. Save files via WebDAV, not WOPI PutFile.</li>
    </ul>

    <pre>inject → collabora-wopi (capabilities) → debug</pre>
@@ -20,47 +20,47 @@

 <script type="text/html" data-template-name="nc-collab-config">
    <div class="form-row">
-        <label for="node-config-input-name"><i class="fa fa-tag"></i> Namn</label>
-        <input type="text" id="node-config-input-name" placeholder="t.ex. cloud.hannesahlin.se">
+        <label for="node-config-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-config-input-name" placeholder="e.g. cloud.example.com">
    </div>
    <div class="form-row">
        <label for="node-config-input-nextcloudUrl"><i class="fa fa-cloud"></i> Nextcloud URL</label>
        <input type="text" id="node-config-input-nextcloudUrl">
    </div>
    <div class="form-row">
-        <label for="node-config-input-collaboraUrl"><i class="fa fa-server"></i> Collabora intern URL</label>
+        <label for="node-config-input-collaboraUrl"><i class="fa fa-server"></i> Collabora internal URL</label>
        <input type="text" id="node-config-input-collaboraUrl">
    </div>
    <div class="form-row">
-        <label for="node-config-input-collaboraPublicUrl"><i class="fa fa-globe"></i> Collabora publik URL (valfri)</label>
+        <label for="node-config-input-collaboraPublicUrl"><i class="fa fa-globe"></i> Collabora public URL (optional)</label>
        <input type="text" id="node-config-input-collaboraPublicUrl">
    </div>
    <div class="form-row">
-        <label for="node-config-input-username"><i class="fa fa-user"></i> Användare</label>
+        <label for="node-config-input-username"><i class="fa fa-user"></i> Username</label>
        <input type="text" id="node-config-input-username">
    </div>
    <div class="form-row">
-        <label for="node-config-input-password"><i class="fa fa-key"></i> App-lösenord</label>
+        <label for="node-config-input-password"><i class="fa fa-key"></i> App password</label>
        <input type="password" id="node-config-input-password">
    </div>
    <div class="form-row">
-        <label for="node-config-input-verifyTls"><i class="fa fa-lock"></i> Verifiera TLS</label>
+        <label for="node-config-input-verifyTls"><i class="fa fa-lock"></i> Verify TLS</label>
        <input type="checkbox" id="node-config-input-verifyTls" style="width:auto">
    </div>
 </script>

 <script type="text/html" data-help-name="nc-collab-config">
-    <p>Config-nod — syns inte i paletten som flödesnod, men alla sex Collabora-noder behöver en sådan här.</p>
-    <p>Utan config gör inget av dem något.</p>
+    <p>Config node — not in the flow palette, but all six Collabora nodes need one.</p>
+    <p>Without this, none of them do anything.</p>

-    <h4>Två backender</h4>
+    <h4>Two backends</h4>
    <ul>
-        <li><strong>Nextcloud</strong> (<code>nextcloudUrl</code>) — filer via WebDAV + Office-API (OCS richdocuments). T.ex. <code>https://cloud.hannesahlin.se</code></li>
-        <li><strong>Collabora CODE</strong> (<code>collaboraUrl</code>) — konverteringsmotorn (<code>/cool/...</code>). Intern Docker bridge, t.ex. <code>https://172.17.0.2:9980</code>. IP hämtas vid install med <code>docker inspect</code> — hardkoda inte blint.</li>
+        <li><strong>Nextcloud</strong> (<code>nextcloudUrl</code>) — files via WebDAV + Office API (OCS richdocuments)</li>
+        <li><strong>Collabora CODE</strong> (<code>collaboraUrl</code>) — conversion engine (<code>/cool/...</code>). Internal Docker bridge, e.g. <code>https://172.17.0.2:9980</code>. IP is detected at install — don't hardcode blindly on every host.</li>
    </ul>

-    <p><strong>Auth:</strong> användarnamn + <em>app-lösenord</em>. Inte vanligt kontolösen.</p>
-    <p><code>collaboraPublicUrl</code> — vad webbläsaren ska se vid WOPI/editor-länkar (proxad CODE via Nextcloud). Intern IP funkar inte i iframe.</p>
-    <p><code>verifyTls</code> — stäng av mot intern CODE om cert inte matchar IP/host.</p>
-    <p>Standardutdata i bridge om du inte anger mål: <code>/Dokument/OfficeOut/</code></p>
+    <p><strong>Auth:</strong> username + <em>app password</em>. Not your normal account password.</p>
+    <p><code>collaboraPublicUrl</code> — what the browser sees for WOPI/editor links (CODE proxied via Nextcloud). Internal IP won't work in an iframe.</p>
+    <p><code>verifyTls</code> — turn off for internal CODE when the cert doesn't match IP/hostname.</p>
+    <p>Default output folder in bridge if you omit a destination: <code>/Dokument/OfficeOut/</code></p>
 </script>
@@ -18,7 +18,7 @@

 <script type="text/html" data-template-name="nc-office">
    <div class="form-row">
-        <label for="node-input-name"><i class="fa fa-tag"></i> Namn</label>
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
        <input type="text" id="node-input-name">
    </div>
    <div class="form-row">
@@ -41,25 +41,25 @@
 </script>

 <script type="text/html" data-help-name="nc-office">
-    <p><strong>Nextcloud Office-API.</strong> Trafik till Nextcloud OCS richdocuments — inte direkt till <code>/cool</code> (utom <code>files:convert</code> som internt kör WebDAV + CODE + WebDAV).</p>
-    <p>Bas: <code>.../ocs/v2.php/apps/richdocuments/api/v1/...</code></p>
+    <p><strong>Nextcloud Office API.</strong> Traffic goes to Nextcloud OCS richdocuments — not directly to <code>/cool</code> (except <code>files:convert</code>, which internally runs WebDAV + CODE + WebDAV).</p>
+    <p>Base: <code>.../ocs/v2.php/apps/richdocuments/api/v1/...</code></p>

    <table style="width:100%; font-size:11px;">
-        <tr><th>Operation</th><th>Gör</th></tr>
-        <tr><td><code>templates:list</code></td><td>Lista mallar (ev. <code>templateType</code>)</td></tr>
-        <tr><td><code>templates:create</code></td><td>Ny fil från NC-mall</td></tr>
-        <tr><td><code>template:extractFields</code></td><td>Fält-JSON (som extract, via NC)</td></tr>
-        <tr><td><code>template:fillFields</code></td><td>Fyll mall, spara i NC</td></tr>
-        <tr><td><code>document:direct</code></td><td><code>editorUrl</code> — öppna fil i Office</td></tr>
-        <tr><td><code>document:public</code></td><td>Samma via <code>shareToken</code></td></tr>
-        <tr><td><code>files:convert</code></td><td>NC-fil → ny NC-fil (t.ex. PDF)</td></tr>
-        <tr><td><code>assets:create</code></td><td>Engångslänk för infogning i öppen editor</td></tr>
+        <tr><th>Operation</th><th>Does</th></tr>
+        <tr><td><code>templates:list</code></td><td>List templates (optional <code>templateType</code>)</td></tr>
+        <tr><td><code>templates:create</code></td><td>New file from NC template</td></tr>
+        <tr><td><code>template:extractFields</code></td><td>Field JSON (like extract, via NC)</td></tr>
+        <tr><td><code>template:fillFields</code></td><td>Fill template, save in NC</td></tr>
+        <tr><td><code>document:direct</code></td><td><code>editorUrl</code> — open file in Office</td></tr>
+        <tr><td><code>document:public</code></td><td>Same with <code>shareToken</code></td></tr>
+        <tr><td><code>files:convert</code></td><td>NC file → new NC file (e.g. PDF)</td></tr>
+        <tr><td><code>assets:create</code></td><td>One-shot URL to insert into open editor</td></tr>
    </table>

-    <p><code>fileId</code> kan saknas — slås upp med WebDAV PROPFIND från <code>ncPath</code>.</p>
-    <p>Överstyr via <code>msg.operation</code>. Gemensamma fält: <code>ncPath</code>, <code>fileId</code>, <code>destNcPath</code>, <code>fields</code>.</p>
+    <p><code>fileId</code> can be omitted — looked up via WebDAV PROPFIND from <code>ncPath</code>.</p>
+    <p>Override via <code>msg.operation</code>. Common fields: <code>ncPath</code>, <code>fileId</code>, <code>destNcPath</code>, <code>fields</code>.</p>

-    <pre>inject { ncPath: "/Dokument/avtal.docx" }
+    <pre>inject { ncPath: "/Documents/contract.docx" }
  → nc-office (document:direct)
  → debug (editorUrl)</pre>
 </script>
@@ -25,4 +25,4 @@ EOF
 fi

 tar -cf /dev/null --exclude-from="${DI}" -C "${NODERED_DIR}" . \
-  && echo "[fix] Build context OK — kör ./install.sh"
+  && echo "[fix] Build context OK — run ./install.sh"
@@ -1,9 +1,9 @@
 #!/usr/bin/env bash
-# Snabbfix om git "dubious ownership" efter root-kloning
+# Quick fix if git reports "dubious ownership" after root clone
 set -euo pipefail
 DIR="${1:-/home/ncadmin/nextcloud-collabora-nodered}"
 USER="${2:-ncadmin}"
 echo "chown ${USER} ${DIR}"
 chown -R "${USER}:${USER}" "${DIR}"
 sudo -u "${USER}" git config --global --add safe.directory "${DIR}"
-echo "Klart. Kör: cd ${DIR} && ./install.sh"
+echo "Done. Run: cd ${DIR} && ./install.sh"
@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
-# integrate-into-nodered.sh — lägg Collabora-noder i BEFINTLIG nextcloud-node-red (:1880)
-# Anropas av install.sh / bootstrap-install.sh (standardläge).
+# integrate-into-nodered.sh — add Collabora nodes to EXISTING nextcloud-node-red (:1880)
+# Called by install.sh / bootstrap-install.sh (default mode).
 set -euo pipefail

 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -14,8 +14,8 @@ NEXTCLOUD_URL="${NEXTCLOUD_URL:-https://cloud.hannesahlin.se}"
 MARKER="nextcloud-collabora-nodered"

 log() { printf '[integrate] %s\n' "$*"; }
-warn() { printf '[integrate] VARNING: %s\n' "$*" >&2; }
-die() { printf '[integrate] FEL: %s\n' "$*" >&2; exit 1; }
+warn() { printf '[integrate] WARNING: %s\n' "$*" >&2; }
+die() { printf '[integrate] ERROR: %s\n' "$*" >&2; exit 1; }

 run_as_root() {
    if [ "$(id -u)" -eq 0 ]; then
@@ -23,7 +23,7 @@ run_as_root() {
    elif command -v sudo >/dev/null 2>&1; then
        sudo "$@"
    else
-        die "sudo/root krävs för: $*"
+        die "sudo/root required for: $*"
    fi
 }

@@ -45,12 +45,12 @@ patch_dockerignore() {
    local snippet="${PKG_SRC}/integrate/dockerignore.snippet"

    if [ ! -f "${di}" ]; then
-        log "Skapar .dockerignore"
+        log "Creating .dockerignore"
        touch "${di}"
    fi

    if ! grep -q "${DOCKERIGNORE_MARKER}" "${di}" 2>/dev/null; then
-        log "Patchar .dockerignore (exkluderar oläsbara lokala artefakter)"
+        log "Patching .dockerignore (exclude unreadable local artifacts)"
        {
            echo ""
            echo "# ${DOCKERIGNORE_MARKER}"
@@ -72,7 +72,7 @@ patch_dockerignore() {
    while IFS= read -r relpath; do
        [ -n "${relpath}" ] || continue
        if ! grep -qxF "${relpath}" "${di}" 2>/dev/null; then
-            log "  + .dockerignore: ${relpath} (oläsbar)"
+            log "  + .dockerignore: ${relpath} (unreadable)"
            echo "${relpath}" >> "${di}"
        fi
    done < <(run_as_root find "${NODERED_DIR}/nodes" -type f ! -readable -printf 'nodes/%P\n' 2>/dev/null || true)
@@ -87,7 +87,7 @@ fix_nodered_build_permissions() {
        return 0
    fi

-    log "Fixar ägande och läsrättigheter för ${NODERED_DIR} (innehåll orört)"
+    log "Fixing ownership and read permissions for ${NODERED_DIR} (content unchanged)"
    run_as_root chown -R "${user}:${group}" "${NODERED_DIR}"
    run_as_root find "${NODERED_DIR}/nodes" -type d -exec chmod u+rwx,go+rx {} + 2>/dev/null || true
    run_as_root find "${NODERED_DIR}/nodes" -type f -exec chmod u+rw,go+r {} + 2>/dev/null || true
@@ -102,24 +102,24 @@ verify_build_context() {
    local errfile
    errfile="$(mktemp)"

-    log "Verifierar Docker build context..."
+    log "Verifying Docker build context..."
    patch_dockerignore

    if ! run_as_root tar -cf /dev/null \
        --exclude-from="${di}" \
        -C "${NODERED_DIR}" . 2>"${errfile}"; then
-        warn "Build context-fel:"
+        warn "Build context error:"
        sed 's/^/[integrate]   /' "${errfile}" >&2 || true
        # Sista utväg: tvinga bort kända problemfil
        if [ -f "${NODERED_DIR}/nodes/odds-scraper/odds-scraper" ]; then
            echo "nodes/odds-scraper/odds-scraper" >> "${di}"
-            log "Tvingade nodes/odds-scraper/odds-scraper in i .dockerignore"
+            log "Forced nodes/odds-scraper/odds-scraper into .dockerignore"
        fi
        if ! run_as_root tar -cf /dev/null \
            --exclude-from="${di}" \
            -C "${NODERED_DIR}" . 2>"${errfile}"; then
            rm -f "${errfile}"
-            die "Build context oläsbar efter .dockerignore — se ${di}"
+            die "Build context still unreadable after .dockerignore — see ${di}"
        fi
    fi
    rm -f "${errfile}"
@@ -155,10 +155,10 @@ detect_code_ip() {
        return 0
    fi
    if [ -n "${COLLABORA_IP}" ]; then
-        warn "Kunde inte läsa bridge-IP — använder COLLABORA_IP=${COLLABORA_IP}"
+        warn "Could not read bridge IP — using COLLABORA_IP=${COLLABORA_IP}"
        return 0
    fi
-    die "CODE bridge-IP saknas — sätt COLLABORA_IP eller kontrollera att ${CODE_CONTAINER} kör på Docker bridge"
+    die "CODE bridge IP missing — set COLLABORA_IP or ensure ${CODE_CONTAINER} runs on Docker bridge"
 }

 detect_nodered_dir() {
@@ -170,7 +170,7 @@ detect_nodered_dir() {
    from_compose="$(docker inspect -f '{{index .Config.Labels "com.docker.compose.project.working_dir"}}' "${NODERED_CONTAINER}" 2>/dev/null || true)"
    if [ -n "${from_compose}" ] && [ -f "${from_compose}/Dockerfile" ]; then
        NODERED_DIR="${from_compose}"
-        log "Node-RED-katalog från compose-label: ${NODERED_DIR}"
+        log "Node-RED directory from compose label: ${NODERED_DIR}"
        return 0
    fi

@@ -179,12 +179,12 @@ detect_nodered_dir() {
        "/opt/nextcloud-node-red"; do
        if [ -f "${candidate}/Dockerfile" ]; then
            NODERED_DIR="${candidate}"
-            log "Node-RED-katalog hittad: ${NODERED_DIR}"
+            log "Node-RED directory found: ${NODERED_DIR}"
            return 0
        fi
    done

-    die "NODERED_DIR saknas eller ogiltig — sätt sökväg till befintlig nextcloud-node-red (Dockerfile + entrypoint.sh)"
+    die "NODERED_DIR missing or invalid — set path to existing nextcloud-node-red (Dockerfile + entrypoint.sh)"
 }

 resolve_paths() {
@@ -206,24 +206,24 @@ resolve_paths() {

 stop_sidecar_if_any() {
    if docker ps -a --format '{{.Names}}' | grep -qx "nextcloud-collabora-nodered"; then
-        warn "Stoppar felaktig sidecar-container nextcloud-collabora-nodered (skulle inte skapas)"
+        warn "Stopping stray sidecar container nextcloud-collabora-nodered (should not exist)"
        docker stop nextcloud-collabora-nodered 2>/dev/null || true
        docker rm nextcloud-collabora-nodered 2>/dev/null || true
    fi
 }

 preflight() {
-    [ -d "${PKG_SRC}" ] || die "Paketkälla saknas: ${PKG_SRC}"
-    [ -f "${PKG_SRC}/package.json" ] || die "package.json saknas i ${PKG_SRC}"
-    [ -d "${NODERED_DIR}" ] || die "nextcloud-node-red saknas: ${NODERED_DIR}"
-    [ -f "${NODERED_DIR}/Dockerfile" ] || die "Dockerfile saknas i ${NODERED_DIR}"
-    [ -f "${NODERED_DIR}/entrypoint.sh" ] || die "entrypoint.sh saknas i ${NODERED_DIR}"
+    [ -d "${PKG_SRC}" ] || die "Package source missing: ${PKG_SRC}"
+    [ -f "${PKG_SRC}/package.json" ] || die "package.json missing in ${PKG_SRC}"
+    [ -d "${NODERED_DIR}" ] || die "nextcloud-node-red missing: ${NODERED_DIR}"
+    [ -f "${NODERED_DIR}/Dockerfile" ] || die "Dockerfile missing in ${NODERED_DIR}"
+    [ -f "${NODERED_DIR}/entrypoint.sh" ] || die "entrypoint.sh missing in ${NODERED_DIR}"

    if ! docker ps --format '{{.Names}}' | grep -qx "${NODERED_CONTAINER}"; then
-        die "Container '${NODERED_CONTAINER}' körs inte — starta befintlig nextcloud-node-red först"
+        die "Container '${NODERED_CONTAINER}' is not running — start existing nextcloud-node-red first"
    fi
    if ! docker ps --format '{{.Names}}' | grep -qx "${CODE_CONTAINER}"; then
-        die "CODE-container '${CODE_CONTAINER}' körs inte"
+        die "CODE container '${CODE_CONTAINER}' is not running"
    fi
 }

@@ -232,25 +232,25 @@ assert_package_layout() {
    local missing=0

    if [ ! -f "${dest}/package.json" ]; then
-        warn "Saknas: ${dest}/package.json"
+        warn "Missing: ${dest}/package.json"
        missing=1
    fi
    if [ ! -d "${dest}/lib" ] || [ -z "$(ls -A "${dest}/lib" 2>/dev/null)" ]; then
-        warn "Saknas eller tom: ${dest}/lib/"
+        warn "Missing or empty: ${dest}/lib/"
        missing=1
    fi
    if [ ! -d "${dest}/nodes" ] || [ -z "$(ls -A "${dest}/nodes" 2>/dev/null)" ]; then
-        warn "Saknas eller tom: ${dest}/nodes/"
+        warn "Missing or empty: ${dest}/nodes/"
        missing=1
    fi
    if [ "${missing}" -ne 0 ]; then
-        die "Paketlayout fel efter kopiering — förväntat package.json + lib/ + nodes/ under ${dest}"
+        die "Wrong package layout after copy — expected package.json + lib/ + nodes/ under ${dest}"
    fi
 }

 copy_node_package() {
    local dest="${NODERED_DIR}/nodes/nextcloud-collabora"
-    log "Kopierar paket → ${dest} (lib/ + nodes/, inte platt)"
+    log "Copying package → ${dest} (lib/ + nodes/, not flat)"

    rm -rf "${dest}"
    mkdir -p "${dest}/lib" "${dest}/nodes"
@@ -265,16 +265,16 @@ copy_node_package() {
    fi

    assert_package_layout "${dest}"
-    log "Paketlayout OK: ${dest}/{package.json,lib/,nodes/}"
+    log "Package layout OK: ${dest}/{package.json,lib/,nodes/}"
 }

 patch_dockerfile() {
    local df="${NODERED_DIR}/Dockerfile"
    if grep -q "${MARKER}" "${df}"; then
-        log "Dockerfile redan patchad"
+        log "Dockerfile already patched"
        return 0
    fi
-    log "Patchar Dockerfile"
+    log "Patching Dockerfile"
    cat >> "${df}" <<'EOF'

 # nextcloud-collabora-nodered — Collabora/Office-noder (WebDAV + CODE REST)
@@ -291,16 +291,16 @@ patch_entrypoint() {

    # Rensa trasig tidigare patch (rå cp-rader utan install_nodes)
    if grep -q 'cp -a /opt/nextcloud-nodes/node-red-contrib-nextcloud-collabora' "${ep}"; then
-        log "Rensar trasig collabora-patch i entrypoint.sh"
+        log "Removing broken collabora patch from entrypoint.sh"
        sed -i '/cp -a \/opt\/nextcloud-nodes\/node-red-contrib-nextcloud-collabora/d' "${ep}"
    fi

    if grep -q 'install_nodes.*Nextcloud Collabora' "${ep}"; then
-        log "entrypoint.sh redan patchad (Collabora install_nodes)"
+        log "entrypoint.sh already patched (Collabora install_nodes)"
        return 0
    fi

-    log "Patchar entrypoint.sh (install_nodes för Collabora)"
+    log "Patching entrypoint.sh (install_nodes for Collabora)"
    if grep -q 'install_nodes.*Nextcloud OCS' "${ep}"; then
        sed -i '/install_nodes.*Nextcloud OCS/a\
 install_nodes "/opt/nextcloud-nodes/node-red-contrib-nextcloud-collabora" "/data/node_modules/node-red-contrib-nextcloud-collabora" "Nextcloud Collabora"' "${ep}"
@@ -317,16 +317,16 @@ EOF
 }

 connect_code_network() {
-    log "Ansluter ${NODERED_CONTAINER} till Docker bridge (CODE)"
+    log "Connecting ${NODERED_CONTAINER} to Docker bridge (CODE)"
    if docker network inspect bridge --format '{{range .Containers}}{{.Name}} {{end}}' 2>/dev/null | grep -q "${NODERED_CONTAINER}"; then
-        log "Redan ansluten till bridge"
+        log "Already connected to bridge"
    else
-        docker network connect bridge "${NODERED_CONTAINER}" 2>/dev/null || warn "Kunde inte ansluta bridge — kontrollera manuellt"
+        docker network connect bridge "${NODERED_CONTAINER}" 2>/dev/null || warn "Could not connect bridge — check manually"
    fi
 }

 rebuild_nodered() {
-    log "Bygger om ${NODERED_CONTAINER} (samma instans, port ${NODERED_PORT})..."
+    log "Rebuilding ${NODERED_CONTAINER} (same instance, port ${NODERED_PORT})..."
    fix_nodered_build_permissions
    verify_build_context
    if [ "${FORCE_REBUILD:-0}" = "1" ]; then
@@ -338,36 +338,36 @@ rebuild_nodered() {
 }

 wait_nodered() {
-    log "Väntar på Node-RED :${NODERED_PORT}..."
+    log "Waiting for Node-RED :${NODERED_PORT}..."
    for i in $(seq 1 30); do
        if curl -sf "http://127.0.0.1:${NODERED_PORT}" >/dev/null 2>&1; then
-            log "Node-RED svarar på http://127.0.0.1:${NODERED_PORT}"
+            log "Node-RED responding at http://127.0.0.1:${NODERED_PORT}"
            return 0
        fi
        sleep 2
    done
-    warn "Node-RED svarade inte inom 60 s"
+    warn "Node-RED did not respond within 60 s"
 }

 verify_code_from_nodered() {
    local code_ip
    code_ip="$(code_bridge_ip)"
    [ -n "${code_ip}" ] || code_ip="${COLLABORA_IP}"
-    # CODE lyssnar på HTTPS internt (HTTP ger tom svar)
+    # CODE listens on HTTPS internally (HTTP returns empty reply)
    local url="https://${code_ip}:9980/hosting/capabilities"
-    log "Testar CODE från ${NODERED_CONTAINER}: ${url}"
+    log "Testing CODE from ${NODERED_CONTAINER}: ${url}"
    if docker exec "${NODERED_CONTAINER}" curl -sfk "${url}" >/dev/null 2>&1; then
-        log "OK: CODE nås från befintlig Node-RED-container"
+        log "OK: CODE reachable from Node-RED container"
    else
-        warn "CODE nås inte — kör: docker network connect bridge ${NODERED_CONTAINER}"
+        warn "CODE not reachable — run: docker network connect bridge ${NODERED_CONTAINER}"
        warn "nc-collab-config collaboraUrl=https://${code_ip}:9980 (verifyTls=false)"
    fi
 }

 main() {
    resolve_paths
-    log "Integrerar Collabora-noder i befintlig nextcloud-node-red"
-    log "Paket: ${PKG_SRC}"
+    log "Integrating Collabora nodes into existing nextcloud-node-red"
+    log "Package: ${PKG_SRC}"
    log "Node-RED: ${NODERED_DIR} (container ${NODERED_CONTAINER})"

    stop_sidecar_if_any
@@ -388,18 +388,18 @@ main() {

    cat <<EOF

-Integrering klar — samma Node-RED på port ${NODERED_PORT}
+Integrating done — same Node-RED on port ${NODERED_PORT}
  UI: http://${host_ip}:${NODERED_PORT}
-  Noder: palett "nextcloud collabora" (6 st + config)
+  Palette: "nextcloud collabora" (6 nodes + config)

-Skapa config först (kugghjul → nc-collab-config):
+Create config first (gear → nc-collab-config):
  Nextcloud:     ${nc_url}
  Collabora:     https://${code_ip}:9980  (verifyTls=false)
-  Publik WOPI:   ${nc_url}
-  Auth:          användarnamn + app-lösenord
+  Public WOPI:   ${nc_url}
+  Auth:          username + app password

-Testa: collabora-wopi (capabilities) → collabora-bridge (ncFileToPdf)
-Exempelflöde: flows/example-flows.json
+Try: collabora-wopi (capabilities) → collabora-bridge (ncFileToPdf)
+Example flow: flows/example-flows.json

 EOF
 }
@@ -1,6 +1,6 @@
 module.exports = {
    uiPort: process.env.PORT || 1881,
-    credentialSecret: process.env.NODERED_CREDENTIAL_SECRET || "byt-den-här-hemligheten-vid-produktion",
+    credentialSecret: process.env.NODERED_CREDENTIAL_SECRET || "change-this-secret-in-production",
    flowFile: "flows.json",
    userDir: "/data",
    logging: {