dev
5ca7b4d4e0
- collaboraUrl -> https://code:9980 överallt (config-node, example-flows, .env.example, docker-compose.yml, install.sh, resolve_collabora_url); http://code:9980 failar när CODE kör SSL - verifyTls=false är nu ett krav (self-signed internt) i hjälptext/dok - integrate: connect_nodered_bridge efter container-up (docker network connect bridge, ignorerar already connected) + verifiering via docker exec curl -sk https://code:9980/hosting/capabilities (HTTP 200) - Publik URL förblir https://docs.domain.name i docs
86 lines
2.8 KiB
Markdown
86 lines
2.8 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
curl -fsSL https://git.domain.name/your-user/nextcloud-collabora-nodered/raw/branch/main/bootstrap-install.sh | sudo -u ncdeploy 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
|
|
|
|
```bash
|
|
cd /path/to/nextcloud-collabora-nodered
|
|
git pull
|
|
./install.sh
|
|
```
|
|
|
|
## Manual integration
|
|
|
|
```bash
|
|
NODERED_DIR=/path/to/nextcloud-node-red ./scripts/integrate-into-nodered.sh
|
|
```
|
|
|
|
## Sidecar :1881 (not recommended)
|
|
|
|
Only if you explicitly want a separate instance:
|
|
|
|
```bash
|
|
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`
|
|
|
|
## Collabora URLs — intern vs publik
|
|
|
|
- **Intern `collaboraUrl`** (Node-RED → CODE): **HTTPS**, self-signed — `https://code:9980` när CODE delar nätverk med Node-RED (`ssl.enable=true`; `http://code:9980` failar), eller fallback `https://<bridge-ip>:9980` (t.ex. `172.17.0.x`) efter `docker network connect bridge nextcloud-node-red`. Sätt `verifyTls=false` i config-noden (self-signed internt).
|
|
- **Publik `collaboraPublicUrl`** (browser/WOPI): `https://docs.domain.name` — CODE via reverse proxy.
|
|
|
|
Full guide and examples: **[docs/NODES.md](docs/NODES.md)** · import **[flows/example-flows.json](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` |
|
|
|
|
```bash
|
|
cp .env.example .env # set NEXTCLOUD_URL for your VM
|
|
git pull
|
|
./install.sh # needs root/sudo for docker compose
|
|
```
|
|
|
|
## Repo
|
|
|
|
https://git.domain.name/your-user/nextcloud-collabora-nodered
|
|
|
|
## Documentation
|
|
|
|
- [docs/NODES.md](docs/NODES.md) — node reference and examples
|
|
- [docs/INFRASTRUCTURE.md](docs/INFRASTRUCTURE.md) — server layout
|