n8n Nodes for IONOS Cloud

Official IONOS Cloud n8n community nodes

Automate your cloud infrastructure, DNS, CDN, certificates, and AI workflows with n8n

Installation • Operations • Credentials • Usage • Examples • Resources

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.

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 | 4 | 20 | Foundation model inference, RAG capabilities, 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.

Account & Global Resources (12 operations)

• Contract (1): Get Many
• Location (2): Get, Get Many
• Image (2): Get, Get Many
• IP Block (4): Create, Delete, Get, Get Many
• Request (3): Get, Get All, Get Status

Core Infrastructure (10 operations)

• Datacenter (5): Create, Delete, Get, Get Many, Update
• LAN (5): Create, Delete, Get, Get Many, Update

Compute Resources (41 operations)

• Server (21): Attach/Detach CDROM/Volume, Create, Delete, Get (+ CDROM/CDROMs/Volume/Volumes/Remote Console/Token), Get Many, Reboot, Resume, Start, Stop, Suspend, Update, Upgrade
• Volume (6): Create, Create Snapshot, Delete, Get, Get Many, Update
• Snapshot (4): Delete, Get, Get Many, Update
• NIC (5): Create, Delete, Get, Get Many, Update
• Firewall Rule (5): Create, Delete, Get, Get Many, Update

Kubernetes (11 operations)

• Kubernetes Cluster (6): Create, Delete, Get, Get Many, Get Kubeconfig, Update
• Node Pool (5): Create, Delete, Get, Get Many, Update

Networking (34 operations)

• Private Cross-Connect (5): Create, Delete, Get, Get Many, Update
• Load Balancer (9): Attach/Detach NIC, Create, Delete, Get (+ Balanced NIC/NICs), Get Many, Update
• Network Load Balancer (5): Create, Delete, Get, Get Many, Update
  • Full support for Flow Logs and Forwarding Rules subresources
• Application Load Balancer (5): Create, Delete, Get, Get Many, Update
  • Full support for Flow Logs and Forwarding Rules subresources with HTTP rules
• Target Group (5): Create, Delete, Get, Get Many, Update
  • Enhanced with location and protocolVersion properties
• NAT Gateway (5): Create, Delete, Get, Get Many, Update
  • Full support for Flow Logs and Rules subresources

Security (5 operations)

• Security Group (5): Create, Delete, Get, Get Many, Update
  • Full support for Rules subresource with comprehensive rule properties

Certificate Resource (5 operations)

Upload and manage SSL/TLS certificates manually with full chain and private key support.

• Create, Delete, Get, Get Many, Update

AutoCertificate Resource (5 operations)

Configure automatic certificate renewal via ACME providers (Let's Encrypt, etc.).

• Create, Delete, Get, Get Many, Update
• Key Algorithms: RSA (2048/4096), ECDSA (256/384)
• Features: Subject Alternative Names (SANs), common name, provider selection

Provider Resource (5 operations)

Configure ACME certificate providers with External Account Binding (EAB) support.

• Create, Delete, Get, Get Many, Update

Zone Resource (5 operations)

Manage primary DNS zones.

• Create, Delete, Get, Get Many, Update

Record Resource (5 operations)

Manage DNS records with 15 supported types: A, AAAA, ALIAS, CAA, CNAME, DS, HTTPS, MX, NS, SMIMEA, SRV, SSHFP, SVCB, TLSA, TXT

• Create, Delete, Get, Get Many, Update

SecondaryZone Resource (7 operations)

Secondary zones with AXFR (zone transfer) support.

• Create, Delete, Get, Get Many, Update, AXFR Get, AXFR Start

ZoneFile Resource (2 operations)

Import/export zones in BIND format (RFC 1035).

• Get (export), Update (import)

Quota Resource (1 operation)

View DNS resource usage and limits.

• Get

DNSSEC Resource (3 operations)

Enable and manage DNSSEC for zones.

• Create (enable), Delete (disable), Get

ReverseRecord Resource (5 operations)

Manage reverse DNS (PTR) records for IPv4/IPv6.

• Create, Delete, Get, Get Many, Update

Distribution Resource (5 operations)

Configure CDN distributions with custom routing rules.

• Create, Delete, Get, Get Many, Update
• Features: Domain routing, SSL/TLS integration, HTTP/HTTPS schemes, geo-restrictions, upstream origins

Ip Resource (2 operations)

Get CDN edge server IPs for origin whitelisting.

• Get, Get Many

Model Resource (2 operations)

Browse and invoke foundation models for AI inference.

• Get Many (list available models), Predict (run inference)
• Features: RAG support via collection queries, custom model options, streaming responses

Collection Resource (6 operations)

Manage vector database collections for document storage and retrieval.

• Create, Delete, Get, Get Many, Update, Query
• Features: Chunking strategies (sentence/fixed/recursive), embedding models, database types (chromadb/pgvector), semantic search

Document Resource (7 operations)

Manage documents within collections for RAG applications.

• Add, Delete, Delete All, Get, Get Many, Get Chunks, Update
• Features: Base64 content encoding, metadata management, chunk retrieval, batch operations

OpenAI Compatible Resource (5 operations)

Use OpenAI-compatible API endpoints for standardized AI interactions.

Chat Completion - Create chat completions with message history

• Supports system, user, and assistant message roles
• Parameters: model, messages (required), temperature, top_p, max_tokens, max_completion_tokens, n, stream, stop, presence_penalty, frequency_penalty, logit_bias, response_format, tools, tool_choice, user
• Compatible with OpenAI chat completion API format

Completion - Simple text completion

• Parameters: model, prompt (required), temperature, top_p, max_tokens, n, stream, stop, presence_penalty, frequency_penalty, logit_bias, user
• Compatible with OpenAI completion API format

Create Embeddings - Generate vector embeddings from text

• Parameters: model (default: BAAI/bge-large-en-v1.5), input (single text or comma-separated multiple texts)
• Returns embedding vectors for semantic search and similarity

Generate Image - Text-to-image generation

• Parameters: model (default: black-forest-labs/FLUX.1-schnell), prompt (required), n, size (1024x1024, 1024x1792, 1792x1024), response_format (b64_json), user
• Generates images from text descriptions

Get Many - List available models

• Returns all models in OpenAI-compatible format
• Shows model capabilities and availability

API Endpoint: https://openai.inference.de-txl.ionos.com (path: /v1/*)

Features: Full OpenAI API compatibility, drop-in replacement for OpenAI in existing workflows, comprehensive parameter support

Note: Model dropdowns are populated dynamically from the IONOS API at runtime (GET /v1/models). When models are added or retired, the dropdown lists update automatically without requiring a node update.

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

• Add the "IONOS Cloud (Infrastructure)" node to your workflow
• Select the resource (e.g., Server, Volume, Datacenter)
• Choose the operation and configure the required fields

Certificate Manager

• Add the "IONOS Cloud (Certificate Manager)" node to your workflow
• Select the resource (Certificate, AutoCertificate, or Provider)
• Configure certificate properties, domains, and ACME providers

DNS

• Add the "IONOS Cloud (Cloud DNS)" node to your workflow
• Select the resource (Zone, Record, SecondaryZone, etc.)
• Configure DNS zones, records, and DNSSEC settings

CDN

• Add the "IONOS Cloud (CDN)" node to your workflow
• Select the resource (Distribution or Ip)
• Configure CDN distributions with routing rules and upstream origins

AI Model Hub

• Add the "IONOS Cloud (AI Model Hub)" node to your workflow
• Select the resource (Model, Collection, Document, or OpenAI Compatible)
• Model: AI inference with native IONOS API
• Collection: Vector database management for RAG
• Document: Manage documents in collections
• OpenAI Compatible: Use OpenAI-compatible endpoints (chat, completions, embeddings, images)

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

AI-Powered Applications with RAG:

1. Use AI Model Hub Collection resource to create a vector database
2. Use Document resource to add knowledge base documents
3. Use Model Predict operation with collection query for context-aware responses
4. Automate document updates and model inference in workflows

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:

• Infrastructure: https://api.ionos.com/cloudapi/v6/
• Certificate Manager: https://certificate-manager.de-fra.ionos.com
• Cloud DNS: https://dns.de-fra.ionos.com
• CDN: https://cdn.de-fra.ionos.com
• AI Model Hub (Inference API): https://inference.de-txl.ionos.com
• AI Model Hub (OpenAI Compatible API): https://openai.inference.de-txl.ionos.com

Resources

• n8n community nodes documentation
• IONOS Cloud Documentation
• Infrastructure API Documentation
• Certificate Manager API Documentation
• Cloud DNS API Documentation
• CDN API Documentation
• AI Model Hub API Documentation
• AI Model Hub OpenAI-compatible API Documentation

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

• 📖 Documentation
• 💬 GitHub Issues
• 🌐 IONOS Cloud
• 📧 Support

Made with ❤️ by the IONOS Cloud team