Description

@opencloud-eu/n8n-nodes-opencloud

> n8n community node for OpenCloud — files, folders
> and shares against the OpenCloud API.

Built on top of Libre Graph
(metadata, sharing, drive enumeration) and OpenCloud WebDAV (content I/O,
copy, move, delete).

!Smoke workflow in the n8n editor — every operation in one chain

—

Operations

| Resource | Operations |
| — | — |
| Space | List |
| File | Copy · Delete · Download · Move · Share · Upload |
| Folder | Copy · Create · Delete · List · Move · Share |
| User | Create · Delete · Get · Get Many · Update (admin only) |

Credentials

| Field | Notes |
| — | — |
| Server URL | e.g. https://opencloud.example.com |
| User | username or email |
| Password | app token (preferred) or account password — Basic auth |
| Skip TLS verification | accept self-signed or otherwise untrusted certs |

Generate an app token from your OpenCloud profile for automation use; account
passwords work for quick tests.

Install

> Status: not yet published to npm. Once published, this will be installable
> from n8n’s UI: **Settings → Community Nodes → Install →
> @opencloud-eu/n8n-nodes-opencloud**.

For now, install from source:

git clone https://github.com/opencloud-eu/n8n-nodes-opencloud.git
cd n8n-nodes-opencloud
pnpm install
pnpm build
Then either:
  a) symlink into your n8n custom-nodes directory
mkdir -p ~/.n8n/custom
ln -s "$(pwd)" ~/.n8n/custom/n8n-nodes-opencloud
  b) or pack and install via the n8n UI
pnpm pack
Settings → Community Nodes → Install → upload the .tgz

Restart n8n after either step.

—

Development

Requires Node.js ≥ 20.15.

pnpm install
pnpm build        # compile to dist/
pnpm test         # vitest unit tests (mocked, fast)
pnpm test:e2e     # Playwright end-to-end (see below)
pnpm lint         # n8n-node lint, strict / Cloud-compatible
pnpm typecheck

Docker dev loop

Pinned n8n in a container with this node mounted in; hot-reloads on dist/
changes via N8NDEVRELOAD=true:

pnpm build              # one-off before first start
docker compose up       # foreground
pnpm build:w            # in another terminal — tsc --watch

Open and log in as admin@example.com / admin.
Workflow editor → add node → search OpenCloud.

Reset to a clean DB:

docker compose down -v

Sample workflow

examples/smoke-test.workflow.json exercises every operation against a real
backend (the chain shown at the top of this README). Patch it with your
credential id before importing:

./examples/apply-credentials.sh  > /tmp/smoke.workflow.json

End-to-end smoke

tests/e2e/smoke.spec.ts is a Playwright test that automates the full path:
log in to n8n → create the credential → import the example workflow → run from
the manual trigger → assert success.

For self-contained CI-style runs the compose file ships an OpenCloud service
under the ci profile:

docker compose --profile ci up -d
OPENCLOUD_URL=https://opencloud:9200 pnpm test:e2e

To target your own backend:

docker compose up -d
OPENCLOUD_URL=https://host.docker.internal:9200 pnpm test:e2e

Env vars: OPENCLOUDURL (required), OPENCLOUDUSER /
OPENCLOUDPASSWORD (default admin/admin), N8NURL / N8N_EMAIL /
N8N_PASSWORD (defaults match the compose stack). On failure Playwright
saves traces, screenshots and videos to test-results/.

—

License

MIT — see LICENSE.md. Copyright OpenCloud GmbH.