nextcloud-collabora-nodered/README.md

# nextcloud-collabora-nodered

Collabora/Nextcloud Office-noder för **befintlig** `nextcloud-node-red` på port **1880**.

Skapar **ingen** ny Node-RED-container.

## Standard: integrate (inte 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`.

## Installation (cloud / valfri VM)

```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

## Uppdatera noder

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

## Manuell integration

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

## Sidecar :1881 (ej rekommenderat)

Endast om du uttryckligen vill separat instans:

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

## Noder

Palett: **nextcloud collabora** — sex noder i samma lila, alla kopplade till **nc-collab-config** (kugghjul, inte flödesnod).

`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)**

## Installera på valfri Nextcloud-VM

Kopiera `.env.example` → `.env` och sätt minst `NEXTCLOUD_URL`. Resten detekteras:

| Variabel | Default / auto |
|----------|----------------|
| `NODERED_DIR` | compose-label eller `/home/ncadmin/nextcloud-node-red` |
| `CODE_CONTAINER` | `code` |
| `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
git pull
./install.sh           # root/sudo för docker compose
```

## Repo

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

## Dokumentation

- [docs/AGENT-MANUAL.md](docs/AGENT-MANUAL.md)
- [docs/INFRASTRUCTURE.md](docs/INFRASTRUCTURE.md)