nextcloud-collabora-nodered/README.md

nextcloud-collabora-nodered

Collabora / Nextcloud Office nodes for your existing nextcloud-node-red on port 1880.

Does not create a new Node-RED container.

Default: integrate (not 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.

Quick install

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

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

Update nodes

cd /path/to/nextcloud-collabora-nodered
git pull
./install.sh

Manual integration

NODERED_DIR=/path/to/nextcloud-node-red ./scripts/integrate-into-nodered.sh

Sidecar :1881 (not recommended)

Only if you explicitly want a separate instance:

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

Nodes

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 guide and examples: docs/NODES.md · import flows/example-flows.json

Install on any Nextcloud VM

Copy .env.example → .env and set at least NEXTCLOUD_URL. The rest is auto-detected:

Variable	Default / auto
NODERED_DIR	compose label or common paths
CODE_CONTAINER	code
COLLABORA_IP	bridge IP via docker inspect
NODERED_CONTAINER	nextcloud-node-red
NODERED_PORT	1880

cp .env.example .env   # set NEXTCLOUD_URL for your VM
git pull
./install.sh           # needs root/sudo for docker compose

Repo

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

Documentation

• docs/NODES.md — node reference and examples
• docs/INFRASTRUCTURE.md — server layout