Description

—

Overview

This is the official n8n community node package for IONOS Cloud, developed and maintained by the IONOS Cloud team. n8n is a fair-code licensed workflow automation platform.

The package provides comprehensive integration with key IONOS Cloud services, enabling you to automate infrastructure provisioning, certificate management, DNS operations, CDN distribution, and AI-powered workflows directly from n8n.

Example Workflows

> Looking for ready-to-use workflows?
> Browse community-contributed IONOS workflow templates on the n8n workflows page — import them directly into your n8n instance with one click.

Included Nodes

This package provides seven separate nodes for different IONOS Cloud services:

1. IONOS Cloud (Infrastructure) – Core infrastructure management
2. IONOS Cloud (Certificate Manager) – SSL/TLS certificate management
3. IONOS Cloud (Cloud DNS) – Domain name system management
4. IONOS Cloud (CDN) – Content delivery network management
5. IONOS Cloud (AI Model Hub) – AI model inference and RAG capabilities
6. IONOS Cloud Chat Model ⚡ – LangChain sub-node for n8n’s AI Agent (language model)
7. IONOS Cloud Embeddings ⚡ – LangChain sub-node for n8n’s AI Agent (text embeddings)

—

Getting Started

Prerequisites

Before you begin, you will need:

1. A IONOS Cloud account
2. A Cloud API Bearer token (learn how to generate tokens)
3. n8n installed (version 2.1.5 or higher)

Installation

Follow the installation guide in the n8n community nodes documentation.

#### Quick Installation Steps

1. Go to Settings > Community Nodes
2. Select Install
3. Enter @ionos-cloud/n8n-nodes-ionos-cloud in Enter npm package name
4. Agree to the risks of using community nodes
5. Select Install

Note: After installation, you may need to restart your n8n instance for the new node to be recognized.

Operations

Overview

| Node | Resources | Operations | Description |
|——|———–|————|————-|
| Infrastructure | 21 | 153 | Complete infrastructure management (compute, networking, storage, Kubernetes) |
| Certificate Manager | 3 | 15 | SSL/TLS certificate lifecycle management with ACME support |
| Cloud DNS | 7 | 28 | DNS zones, records (15 types), DNSSEC, zone transfers |
| CDN | 2 | 7 | Content delivery with custom routing and geo-restrictions |
| AI Model Hub | 2 | 7 | Foundation model inference and OpenAI-compatible API |
| Chat Model ⚡ | — | supplyData | LangChain chat model sub-node for n8n AI Agent |
| Embeddings ⚡ | — | supplyData | LangChain embeddings sub-node for n8n AI Agent |

> ⚡ Sub-nodes: The Chat Model and Embeddings nodes are LangChain sub-nodes that plug into n8n’s built-in AI nodes (AI Agent, AI Chain, Vector Stores, etc.) rather than operating as standalone workflow nodes.

> ✨ v1.0.2: Patch release with enhanced subresource support for load balancers, NAT gateways, security groups, and target groups. Added request monitoring capabilities.

—

Credentials

All nodes in this package share a single credential type: IONOS Cloud API

Authentication uses the Cloud API Bearer token.

The same token works across all IONOS Cloud services (Infrastructure, Certificate Manager, DNS, CDN, and AI Model Hub).

Compatibility

Tested against n8n version 2.1.5+

Usage

Authentication

1. Create new credentials in n8n and select “IONOS Cloud API”
2. Provide your API token (generated from IONOS Cloud Console)
3. The same credential works for all five nodes

Using the Nodes

#### Infrastructure

#### Certificate Manager

#### DNS

#### CDN

#### AI Model Hub

#### AI Agent Integration (Chat Model & Embeddings Sub-Nodes)

The IONOS Cloud Chat Model and IONOS Cloud Embeddings are LangChain sub-nodes that integrate with n8n’s built-in AI nodes.

Chat Model — Use IONOS AI Model Hub as the LLM brain for the AI Agent:
1. Add an AI Agent node to your workflow
2. Click + on the AI Agent’s Language Model input
3. Select IONOS Cloud Chat Model
4. Choose your credential and pick a model from the auto-populated dropdown
5. The agent now uses IONOS AI Model Hub for all LLM reasoning

Embeddings — Use IONOS AI Model Hub for text embeddings in RAG pipelines:
1. Add an In-Memory Vector Store (or any vector store node)
2. Click + on the vector store’s Embedding input
3. Select IONOS Cloud Embeddings
4. Choose your credential and pick an embedding model

Example: AI Agent with RAG

Chat Trigger → AI Agent
                 ├── Language Model: IONOS Cloud Chat Model
                 ├── Memory: Window Buffer Memory
                 └── Tool: Vector Store Tool
                              └── In-Memory Vector Store (Load)
                                       └── Embedding: IONOS Cloud Embeddings

> Note: The model dropdowns are populated dynamically from the IONOS API at runtime. Both sub-nodes reuse the same IONOS Cloud API credential as all other nodes in this package.

Common Patterns

Automated SSL Certificate Deployment:
1. Use Certificate Manager to create an AutoCertificate
2. Use CDN node to create a Distribution referencing the certificate ID
3. Automate certificate renewal with n8n scheduling

Infrastructure Provisioning:
1. Use Infrastructure node to create Datacenter, Server, and Volume
2. Use DNS node to create Zone and A/AAAA Records pointing to server IPs
3. Use Certificate Manager to provision SSL certificates for domains

DNS Management:
1. Use DNS Zone resource to create zones
2. Use Record resource to manage DNS records (A, CNAME, MX, TXT, etc.)
3. Use DNSSEC resource to enable DNSSEC signing
4. Use ReverseRecord for PTR records

OpenAI-Compatible AI Integration:
1. Use OpenAI Compatible Chat Completion for conversational AI
2. Use Create Embeddings for semantic search and similarity
3. Use Generate Image for text-to-image generation
4. Drop-in replacement for OpenAI API in existing n8n workflows

AI Agent with IONOS Cloud (native n8n AI integration):
1. Use IONOS Cloud Chat Model as the language model for n8n’s AI Agent
2. Use IONOS Cloud Embeddings with Vector Stores for RAG pipelines
3. Combine with Window Buffer Memory for conversational context
4. Add Vector Store Tool to give the agent access to your knowledge base
5. See examples/ionos-ai-agent-workflow.json for a ready-to-import workflow

Avoiding Rate Limits

The IONOS AI Model Hub API enforces rate limits (300 requests/min, 5 requests/sec with a burst of 10). When a node receives multiple input items (e.g., from a preceding “Get All” operation), n8n executes the node once per item, which can trigger 429 Too Many Requests errors.

To prevent this, configure batching in the node’s Settings tab:

1. Open the AI Model Hub node and go to the Settings tab
2. Under Request Options, click Add Option and select Batching
3. Set Items per Batch to 2 (or lower)
4. Set Batch Interval (ms) to 1000 (or higher)

This ensures n8n processes only a few items at a time with a delay between batches, staying within the API rate limits.

> Tip: If your workflow only needs a single API call (e.g., one Chat Completion), use a Limit node before the AI Model Hub node to reduce the input to 1 item.

API Endpoints

Each node connects to:

Resources

Contributing

We welcome contributions! If you find a bug or have a feature request:

1. Check the GitHub Issues to see if it’s already been reported
2. Open a new issue with a clear description and reproduction steps
3. For feature requests, explain the use case and expected behavior

Development

To contribute code:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes and test thoroughly
4. Commit your changes (git commit -m 'Add amazing feature')
5. Push to the branch (git push origin feature/amazing-feature)
6. Open a Pull Request

License

This project is licensed under the MIT License – see the LICENSE file for details.

Support

—