n3wk/nextcloud-collabora-nodered
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Translate user-facing docs and node help to English

Browse Source 
README, NODES.md, install scripts, palette help text, and example flows — node .js logic unchanged.
This commit is contained in:
dev
2026-08-22 17:36:38 +02:00
parent ff486d41b3
commit 33d7c9c46a
18 changed files with 361 additions and 390 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/INFRASTRUCTURE.md
+30 -52
View File
@@ -1,66 +1,44 @@
# Infrastruktur — cloud.domain.name (192.168.1.10)
# 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/ncdeploy/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.domain.name
- Host: 192.168.1.10, `/var/www/nextcloud`
- Sidecar: `extra_hosts: cloud.domain.name:192.168.1.10`, `verifyTls: false` tills cert i container
## CODE
- `aliasgroup1=https://cloud.domain.name: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://git.domain.name/your-user/nextcloud-collabora-nodered
- SSH port **2222** på host
## Bootstrap (ny VM)
```bash
curl -fsSL https://git.domain.name/your-user/nextcloud-collabora-nodered/raw/branch/main/bootstrap-install.sh | bash
```
## Kataloger på host
## Install paths (example host)
```
/home/ncdeploy/
├── nextcloud-node-red/ # :1880 — orört
├── nextcloud-collabora-nodered/ # :1881 — detta paket
├── your-userode/ # 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://git.domain.name/your-user/nextcloud-collabora-nodered
- SSH git on port 2222 if configured