Click Install. The Openinary node will appear in your node panel.

Credentials

| Field | Description | |----------|-----------------------------------------------------------------------------| | Base URL | The URL of your Openinary instance e.g. http://openinary:3000 | | API Key | Your API key generated from the Openinary dashboard under /api-keys |

If n8n and Openinary are on the same Docker network, use the container name as hostname e.g. http://openinary:3000

Operations

File

| Operation | Description | |-----------|----------------------------------------------------------| | Upload | Upload a file from a binary property into Openinary | | Delete | Delete a file and all its cached transformation variants |

Upload parameters

| Parameter | Required | Description | |------------------------|----------|--------------------------------------------------------------------| | Binary Property | Yes | The binary property in the input item that holds the file | | Destination Folder | No | Folder path to upload into e.g. photos/2024 | | Custom Filename | No | Override the filename. Must include extension e.g. banner.jpg | | Prewarm Transformations| No | Transformation string to pre-cache e.g. w_800,h_600,c_fill |

Delete parameters

| Parameter | Required | Description | |-----------|----------|--------------------------------------------------------------------------| | File Path | Yes | Path of the file relative to storage root e.g. photos/portrait.jpg |

Folder

| Operation | Description | |-----------|---------------------------| | Create | Create an empty folder |

Create parameters

| Parameter | Required | Description | |-------------|----------|------------------------------------------------------| | Folder Path | Yes | Path of the folder to create e.g. products/2024 |

Storage

| Operation | Description | |-----------|----------------------------------------| | List | List the full folder and file tree |

Example workflow

1. Use an HTTP Request node or Read Binary File node to get a file
2. Connect it to the Openinary node
3. Set Resource to File, Operation to Upload
4. Set Binary Property to data
5. Set Destination Folder to your desired folder
6. Run the workflow — the output will contain the uploaded file URL

Docker network setup

If n8n and Openinary run on the same Docker host, make sure both containers are on the same network:

docker network connect your_network your_n8n_container

Then use the Openinary container name as the hostname in the Base URL credential: http://openinary:3000

Links

• Openinary GitHub
• Openinary Docs
• n8n Community Nodes
• npm package

License

MIT