Workflow Installation and Credential Mapping Engine - n8n Workflow

• Users distributing complex solution packages composed of several n8n workflows.


• n8n Administrators requiring automated, standardized deployment of n8n templates.


• Developers needing to share an n8n workflow that requires multiple credential setups.


• Technical teams seeking a DevOps solution for managing and moving n8n workflows between environments.

This powerful n8n workflow functions as a robust installer package for deploying sets of dependent n8n templates. The core challenge it solves is eliminating the requirement to manually configure credentials after importing new n8n workflows. By leveraging the n8n API, this n8n workflow template automates the entire deployment process.

First, you configure your live credentials (such as those for OpenAI, GitHub, and the n8n instance API) in the setup phase. Then, the installer automatically extracts the bundled n8n templates, locates the placeholder credentials within each n8n workflow, and replaces them with your valid, live credential IDs. This ensures that every newly created n8n workflow is immediately functional upon deployment, offering massive efficiency gains for anyone working extensively with n8n.

This highly customized flow is executed manually to manage the deployment of bundled n8n templates.

1. Trigger and Setup: The process begins using the "When clicking ‘Execute workflow’” n8n trigger. The n8n workflow then sequentially gathers connection details from pre-configured n8n nodes (like 'OpenAi Credentials', 'Github Credentials', and 'n8n Credentials'). These IDs, along with optional project assignment data, are compiled into a 'Credential Dictionary'.


2. Validation: The 'If 3 Credentials' n8n node ensures that all required connection fields are populated. If validation fails, the n8n workflow halts with the 'Stop and Error' n8n node.


3. Data Extraction: The installation package, which is typically base64-encoded JSON containing multiple bundled n8n templates, is processed. It is converted to a file, decompressed via the 'Decompress Workflows' n8n node, and then broken down into separate n8n workflow objects using 'Split Workflows'.


4. Credential Mapping: The vital 'Fix Credentials' code n8n node executes custom JavaScript. This code dynamically finds the internal, placeholder credential IDs defined in the imported n8n workflow definitions and replaces them with the actual credential IDs gathered in Step 1. This step is essential for the functionality of the new n8n templates.


5. Deployment Loop: The 'Loop Over Workflows' n8n node iterates through each fixed n8n template.


6. Workflow Creation: For each item, the 'Create Workflow' n8n node interacts with the n8n API to instantiate the new n8n workflow on the host server.


7. Project Assignment: An 'If Project' n8n node checks if a target Project ID was provided. If affirmative, the 'Move to Project' n8n node uses the API to instantly move the newly created n8n workflow into the desired Project space.

To use this n8n workflow template, follow these steps:

1. Import: Copy the JSON code and import it into your n8n instance using the 'New' -> 'Import from JSON' option.


2. n8n API Credentials: You must configure the 'n8n Credentials' n8n node. This requires using a permanent API Key and ensuring your credentials have the necessary permissions to create and move n8n workflows.


3. External Credentials: Configure the 'OpenAi Credentials' and 'Github Credentials' n8n nodes (even if they are just dummy placeholders for the installer itself—the key is to have the correct ID registered on your system).


4. Installer Data: The 'Installer Data' n8n node contains the base64-encoded package of the target n8n templates. This data must be updated to include the n8n workflows you wish to deploy.


5. Execution: Once configured, click the 'Execute workflow' n8n trigger to run the installation process.

Manual Trigger: The initiating n8n trigger that starts the installation upon user command.
n8n Credentials: Functionally configured to connect to the local n8n API endpoint. This is crucial for the 'Create Workflow' n8n node to deploy the new n8n workflow templates.
Credential Dictionary (Set): Gathers the current system Credential IDs needed to correctly map connections within the new n8n templates.
If 3 Credentials (If): A flow control n8n node that acts as a gate, ensuring all necessary connection inputs are present before proceeding with the deployment of the n8n workflow package.
Decompress Workflows (Extract from File): Takes the encoded n8n template package and extracts the internal JSON, making the individual n8n workflow definitions available for manipulation.
Fix Credentials (Code): The most crucial part of this n8n workflow. This custom code dynamically updates the credential placeholder IDs in the incoming n8n templates with the actual credential IDs available on the current n8n instance, ensuring the deployed n8n workflow is immediately usable.

• Create Workflow (n8n node): Sends the processed n8n workflow JSON to the n8n API, resulting in the creation of a new, fully configured n8n workflow on the platform.