nextcloud-collabora-nodered/docs/INFRASTRUCTURE.md

# Infrastruktur — cloud.domain.name (192.168.1.10)

Verifierad 2026-08-22. Sidecar ska passa in utan att röra befintliga tjänster.

## 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 | — |

## Viktigt om nätverk

- **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.

## Nextcloud

- 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

```
/home/ncdeploy/
├── nextcloud-node-red/          # :1880 — orört
├── nextcloud-collabora-nodered/ # :1881 — detta paket
├── your-userode/                     # Gitea compose
├── odds-scraper/                # ignoreras
└── nodered-embed/
```

## Collabora SDK (referens)

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