Official IONOS Cloud n8n community nodes
Automate your cloud infrastructure, DNS, CDN, certificates, and AI workflows with n8n
Installation • Operations • Credentials • Usage • Examples • Resources
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.
This package provides five separate nodes for different IONOS Cloud services:
- IONOS Cloud (Infrastructure) - Core infrastructure management
- IONOS Cloud (Certificate Manager) - SSL/TLS certificate management
- IONOS Cloud (Cloud DNS) - Domain name system management
- IONOS Cloud (CDN) - Content delivery network management
- IONOS Cloud (AI Model Hub) - AI model inference and RAG capabilities
Before you begin, you will need:
- A IONOS Cloud account
- A Cloud API Bearer token (learn how to generate tokens)
- n8n installed (version 2.1.5 or higher)
Follow the installation guide in the n8n community nodes documentation.
- Go to Settings > Community Nodes
- Select Install
- Enter
@ionos-cloud/n8n-nodes-ionos-cloudin Enter npm package name - Agree to the risks of using community nodes
- Select Install
Note: After installation, you may need to restart your n8n instance for the new node to be recognized.
| 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 |
✨ v1.0.2: Patch release with enhanced subresource support for load balancers, NAT gateways, security groups, and target groups. Added request monitoring capabilities.
Infrastructure - Detailed 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
- Datacenter (5): Create, Delete, Get, Get Many, Update
- LAN (5): Create, Delete, Get, Get Many, Update
- 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 Cluster (6): Create, Delete, Get, Get Many, Get Kubeconfig, Update
- Node Pool (5): Create, Delete, Get, Get Many, Update
- 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 Group (5): Create, Delete, Get, Get Many, Update
- Full support for Rules subresource with comprehensive rule properties
Certificate Manager - Detailed Operations
Upload and manage SSL/TLS certificates manually with full chain and private key support.
- Create, Delete, Get, Get Many, Update
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
Configure ACME certificate providers with External Account Binding (EAB) support.
- Create, Delete, Get, Get Many, Update
Cloud DNS - Detailed Operations
Manage primary DNS zones.
- Create, Delete, Get, Get Many, Update
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
Secondary zones with AXFR (zone transfer) support.
- Create, Delete, Get, Get Many, Update, AXFR Get, AXFR Start
Import/export zones in BIND format (RFC 1035).
- Get (export), Update (import)
View DNS resource usage and limits.
- Get
Enable and manage DNSSEC for zones.
- Create (enable), Delete (disable), Get
Manage reverse DNS (PTR) records for IPv4/IPv6.
- Create, Delete, Get, Get Many, Update
CDN - Detailed 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
Get CDN edge server IPs for origin whitelisting.
- Get, Get Many
AI Model Hub - Detailed 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
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
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
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.
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).
Tested against n8n version 2.1.5+
- Create new credentials in n8n and select "IONOS Cloud API"
- Provide your API token (generated from IONOS Cloud Console)
- The same credential works for all five nodes
- 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
- Add the "IONOS Cloud (Certificate Manager)" node to your workflow
- Select the resource (Certificate, AutoCertificate, or Provider)
- Configure certificate properties, domains, and ACME providers
- Add the "IONOS Cloud (Cloud DNS)" node to your workflow
- Select the resource (Zone, Record, SecondaryZone, etc.)
- Configure DNS zones, records, and DNSSEC settings
- Add the "IONOS Cloud (CDN)" node to your workflow
- Select the resource (Distribution or Ip)
- Configure CDN distributions with routing rules and upstream origins
- 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)
Automated SSL Certificate Deployment:
- Use Certificate Manager to create an AutoCertificate
- Use CDN node to create a Distribution referencing the certificate ID
- Automate certificate renewal with n8n scheduling
Infrastructure Provisioning:
- Use Infrastructure node to create Datacenter, Server, and Volume
- Use DNS node to create Zone and A/AAAA Records pointing to server IPs
- Use Certificate Manager to provision SSL certificates for domains
DNS Management:
- Use DNS Zone resource to create zones
- Use Record resource to manage DNS records (A, CNAME, MX, TXT, etc.)
- Use DNSSEC resource to enable DNSSEC signing
- Use ReverseRecord for PTR records
AI-Powered Applications with RAG:
- Use AI Model Hub Collection resource to create a vector database
- Use Document resource to add knowledge base documents
- Use Model Predict operation with collection query for context-aware responses
- Automate document updates and model inference in workflows
OpenAI-Compatible AI Integration:
- Use OpenAI Compatible Chat Completion for conversational AI
- Use Create Embeddings for semantic search and similarity
- Use Generate Image for text-to-image generation
- Drop-in replacement for OpenAI API in existing n8n workflows
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
- 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
We welcome contributions! If you find a bug or have a feature request:
- Check the GitHub Issues to see if it's already been reported
- Open a new issue with a clear description and reproduction steps
- For feature requests, explain the use case and expected behavior
To contribute code:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make your changes and test thoroughly
- Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- 📖 Documentation
- 💬 GitHub Issues
- 🌐 IONOS Cloud
- 📧 Support
Made with ❤️ by the IONOS Cloud team