Automated n8n Workflow Backup to GitHub Repository

Overview

This workflow automatically backs up every workflow in your n8n instance to a dedicated GitHub repository. It runs on a configurable schedule (or manually) and ensures that all your workflow JSON files are version-controlled and safely stored in a structured folder. The backup process intelligently handles both new workflows (creates a file) and existing ones (updates the file), making it ideal for disaster recovery, collaboration, or tracking changes over time.

Step-by-Step Node Breakdown

  1. Schedule Trigger (No additional auth) — Triggers the workflow on a recurring interval. By default it runs hourly, but you can customize the schedule (e.g., daily at midnight) to suit your needs. Also supports manual execution via the Manual Trigger node.
  2. Manual Trigger (No auth) — Provides a manual button to run the backup immediately, useful for testing or on-demand backups.
  3. Get many workflows (Internal n8n API, no external credentials) — Fetches a list of all workflows from your n8n instance using the built-in n8n node. No separate API key is required; it uses the same authentication as your n8n session.
  4. Loop Over Items (No auth) — Iterates over each workflow in the list one at a time. This node processes workflows sequentially, preventing race conditions.
  5. Getafile (GitHub, OAuth2 / Personal Access Token) — Attempts to retrieve the existing workflow file from your GitHub repository at the path workflows/{workflow-name}.json. If the file does not exist (i.e., a new workflow), the node’s error output is triggered. The expression in filePath sanitizes the workflow name by replacing invalid characters (<>:"|?*), converting -> to to, and normalizing spaces.
  6. Convert to File1 (No auth) — Converts the retrieved GitHub file’s binary data back to a JSON object so it can be compared or overwritten.
  7. Extract from File1 (No auth) — Extracts the JSON content from the binary file, preparing it for an update operation.
  8. Edit a file (GitHub, OAuth2 / Personal Access Token) — If the workflow already exists on GitHub, this node updates the file with the latest JSON from your n8n instance. The commit message is dynamically generated (e.g., MyWorkflow-updated).
  9. Convert to File (No auth) — Converts the current n8n workflow JSON into a binary file (.json) with the workflow’s name as the filename.
  10. Create a file (GitHub, OAuth2 / Personal Access Token) — If the workflow is new (i.e., Getafile error output), this node creates a new file in the workflows/ folder. The commit message includes the workflow name and -update.

The workflow loops back to the Loop Over Items node to process the next workflow. The Sticky Note at the top serves as a comment.

Setup Instructions

  • GitHub account — You need a GitHub account and a repository (e.g., n8n-backup) to store the backups. Create an empty repository or use an existing one.
  • GitHub credential in n8n — Add a GitHub OAuth2 or Personal Access Token credential in n8n under Credentials > GitHub. Ensure the token has repo scope (or at least contents: write and contents: read).
  • Configure the nodes —
    • In Get many workflows, no changes needed.
    • In Getafile, Create a file, and Edit a file, update the owner and repository fields to match your GitHub username and repo name.
    • Optionally adjust the Schedule Trigger interval (set hours/minutes as desired).
  • Error handling — The workflow references an external error workflow (nkikA5CaVjEKdIIR). If you don’t have that, you should either create a simple error handler or remove the errorWorkflow setting in the workflow settings.

Use Cases & Adaptations

  • Disaster recovery — Restore all workflows by downloading the JSON files from GitHub and importing them back into n8n.
  • Version history — Track changes to workflows over time via GitHub commits and diffs.
  • Multi-instance sync — Modify the workflow to run on multiple n8n instances, pushing to the same repo (be cautious with conflicts).
  • Selective backup — Add a filter node after Get many workflows to only backup workflows with a specific tag or name pattern.
  • Notification — Insert a Slack or email node after the loop to notify you when a backup completes or if an error occurs.
11 nodesmanual triggerDevOps
N8nSplit In BatchesConvert To FileGithubExtract From FileSticky Note

Workflow JSON

{
  "name": "All Workflow Backup to GitHub",
  "nodes": [
    {
      "parameters": {},
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        -160,
        336
      ],
      "id": "b91b0ed2-380f-49f7-b8fa-7596cd0c68e7",
      "name": "When clicking ‘Execute workflow’"
    },
    {
      "parameters": {
        "filters": {},
        "requestOptions": {}
      },
      "type": "n8n-nodes-base.n8n",
      "typeVersion": 1,
      "position": [
        64,
        288
      ],
      "id": "0230a4c7-6bb8-4a80-8ba8-4c070d1e21d0",
      "name": "Get many workflows"
    },
    {
      "parameters": {
        "rule": {
          "interval": [
            {}
          ]
        }
      },
      "type": "n8n-nodes-base.scheduleTrigger",
      "typeVersion": 1.2,
      "position": [
        -160,
        144
      ],
      "id": "76af76ea-b753-4447-9ee9-cf980b85bf12",
      "name": "Schedule Trigger"
    },
    {
      "parameters": {
        "options": {}
      },
      "type": "n8n-nodes-base.splitInBatches",
// ... truncated (copy to see full JSON)

How to Import This Workflow

  1. 1Copy the workflow JSON above using the Copy Workflow JSON button.
  2. 2Open your n8n instance and go to Workflows.
  3. 3Click Import from JSON and paste the copied workflow.

Don't have an n8n instance? Start your free trial at n8nautomation.cloud

Related Templates

n8n Upgrade: Detect Affected Workflows with Broken Connections

Summary This workflow helps n8n administrators identify workflows that may have been affected by a past upgrade (specifically n8n version ) where multi-output nodes (like , , ) could have their output connections accidentally re-wired. It provides a self-service webhook endpoint that returns an HTML report listing all workflows with potentially broken connections, making it easy to audit and fix them. Node-by-Node Walkthrough Webhook (No auth) — Listens for HTTP GET requests at the path . When a user visits this URL in their browser, the workflow is triggered. The response mode is set to "Response Node", meaning the final output will be sent back directly. Get all workflows (API Key auth) — Uses the n8n API to fetch all workflows from the instance. You must configure this node with an n8n API credential (a personal access token created under Settings > n8n API). The node has no filters, so it retrieves every workflow. Parse potentially affected workflows (Code node, no auth) — A JavaScript code node that loops through each workflow, inspects its connections, and checks if any multi-output node (defined in the array) has empty outputs. If a node has fewer connected outputs than expected, it is flagged as potentially affected. The node outputs a JSON object with an array of affected workflows, each containing , , , and . Generate Report (HTML node, no auth) — Creates a static HTML document with a styled container, a heading, and an empty list. This serves as the shell for the interactive report generated by the next node. Serve HTML Report (Respond to Webhook node, no auth) — Takes the HTML template from the previous node and injects JavaScript that parses the affected workflows data (from the code node) and dynamically builds a list of clickable links. Each link opens the workflow in a new tab so the admin can inspect and fix the connections. The response headers are set to . Setup Instructions Prerequisites: You must have admin access to the n8n instance (the workflow must be run by the instance owner). Create an n8n API key: Go to Settings > n8n API in your n8n instance and generate a personal access token. Copy the token. Configure the "Get all workflows" node: Add an n8n credential of type "API Key" and paste the token. Leave the filters empty. Customize multi-output nodes (if needed): The code node contains a list with the default nodes (, , ). If you have community nodes with multiple outputs, add them to this array with their correct output count. Activate the workflow: Toggle the workflow to active. Use the report: Open your browser and navigate to . The page will list all affected workflows. Click on a row to open the workflow in a new tab — inspect the connections and re-wire them if needed. Use Cases & Variations Post-upgrade audit: Run this workflow after every n8n upgrade to catch connection issues early. Customized detection: Extend the array in the code node to include any custom node type that has multiple outputs. Slack/Email notification: Instead of serving an HTML report, you could send the list of affected workflows to a Slack channel or email using additional nodes. Scheduled scanning: Replace the Webhook trigger with a Schedule trigger to run the check daily and automatically notify the admin.

9 nodes

Disk Space Watchdog with Tiered Thresholds and Telegram Alert

Summary This workflow monitors disk usage on a remote Linux server via SSH, applying tiered thresholds (warning and critical) to avoid alert fatigue. It tracks the last known state of each mount point using n8n's workflow static data, so you only receive a notification when a disk changes level (e.g., from OK to warning, or from critical back to OK). Alerts are sent first to a Telegram chat; if that fails, an email is sent as a reliable fallback. The workflow is fully configurable through environment variables, making it easy to adapt without editing the code. Step-by-Step Nodes Schedule Trigger (No auth) — Runs the workflow every 30 minutes. Configured via rule with minutes interval = 30. Check Disk Usage (SSH) (SSH auth – key or password) — Executes the command on the remote server. You must provide credentials (username + SSH key or password) stored in an n8n credential of type "SSH". Parse & Evaluate (No auth) — A Code node that parses the from the SSH command. It reads thresholds from environment variables ( and , defaulting to 80% and 90%). For each mount point: - Compares usage percentage against thresholds. - Uses to remember the last known level (ok / warning / critical). - Only emits an alert when the level changes (including recovery messages when a disk returns below threshold). - Outputs . Any alerts? (No auth) — An IF node that checks (boolean true). If true, execution goes to the Telegram branch; otherwise the workflow ends silently. Send Telegram Alert (Telegram API – Bot Token auth) — Sends the alert message to a Telegram chat. The chat ID is read from . The node is set to (on error -> next output). On success, no further action. On error, execution flows into the email fallback. Send Email Fallback (SMTP auth – username/password or OAuth2) — Sends the same alert message via email. Uses and for sender and recipient. This ensures alerts are never lost if Telegram is down. Setup Instructions Prerequisites: - A Linux server with SSH access and passwordless sudo (if needed) or a user that can run . - A Telegram bot (create one via @BotFather) and obtain its API token. - A Telegram chat ID (can be a group or your own ID). - An SMTP server (e.g., Gmail, SendGrid, or your own) for email fallback. Environment Variables: Set the following in your n8n environment (e.g., or n8n UI > Workflow > Settings): - (default 80) - (default 90) - (e.g., ) - (e.g., ) - (e.g., ) Create Credentials in n8n: - SSH: Add a credential of type "SSH" with the server host, port (22), username, and either password or private key. - Telegram: Add a credential of type "Telegram API" with the bot token. - SMTP: Add a credential of type "SMTP" with server, port, user, password (and choose authentication method). Bind the credentials to the corresponding nodes in the workflow editor. Use Cases & Variations Server Fleet Monitoring: Duplicate the SSH node or use a loop to check multiple servers; aggregate results in the Code node. Different Thresholds per Mount: Extend the Code node to read a JSON mapping from an env variable or static data. Escalation Chain: Instead of email fallback, add a PagerDuty or Slack node on error. Silence Recoveries: Modify the Code node to skip recovery messages (remove the branch). Run less Frequently: Change the Schedule Trigger to hourly or daily. Add Grafana/Prometheus integration: Replace the SSH node with an HTTP request to your monitoring API. This workflow is ideal for sysadmins and DevOps teams who need reliable, noise‑free disk monitoring without a full‑blown observability stack.

6 nodes

Weekly Zigbee2MQTT Backup to SFTP Server

Overview This workflow automates the weekly backup of your Zigbee2MQTT configuration. It triggers every Monday at 2:45 AM, sends a backup request to the Zigbee2MQTT bridge via MQTT, waits for the response containing a base64-encoded ZIP file, decodes it, and uploads the backup to an SFTP server. The workflow includes error handling to stop execution and log failures if anything goes wrong. This is ideal for home automation enthusiasts or administrators who want to ensure their Zigbee network configuration is safely archived off-site or on a central server. Node Breakdown CRON Monday 2:45 am () — No auth. Runs the workflow every Monday at 02:45 AM using the cron expression . This ensures backups happen automatically without manual intervention. Send Zigbee2MQTT backup request () — MQTT Client credentials (broker URL, port, username/password). Publishes the message to the topic . This triggers the Zigbee2MQTT bridge to generate a backup. MQTT Trigger - Backup Response () — MQTT Trigger credentials (same broker). Listens on the topic for the backup data. The trigger waits for a message and passes it to the next node. Parse JSON Object from Message Text () — No auth. Runs JavaScript to parse the incoming MQTT message, extracting the nested field from the JSON payload. This isolates the base64-encoded ZIP content. Convert to File - base64 to binary () — No auth. Takes the property from the parsed JSON (which contains the base64 string) and converts it to a binary file. The output is a ZIP file ready for upload. SFTP zip file content () — SFTP credentials (username/password or private key). Uploads the generated ZIP file to the specified SFTP server path: . The filename includes a timestamp with colons replaced by underscores. Error Handler () — No auth. If any node above fails, this node stops the workflow with the message . It acts as a safety net to prevent partial or corrupted backups. Setup Instructions SFTP Server: You need an SFTP server (e.g., a NAS, cloud VM, or any SSH‑enabled server). Create a user account and note the host, port, username, and password/private key. In n8n, configure an SFTP credential with these details. MQTT Broker: You need a running MQTT broker (e.g., Mosquitto). The workflow connects to the same broker that your Zigbee2MQTT instance uses. In n8n, create an MQTT credential with broker URL, port, username, and password. Zigbee2MQTT: Ensure your Zigbee2MQTT bridge is accessible via MQTT and that it supports the backup request feature (Zigbee2MQTT must be running and connected to the same broker). n8n Configuration: Import this workflow into your n8n instance. Update the SFTP path if needed, and verify the cron schedule matches your desired backup day/time (currently Monday 2:45 AM). Test: Run the workflow manually once to confirm the backup process completes without errors. Check your SFTP server for the uploaded ZIP file. Use Cases & Variations Home Automation Backup: Regularly archive Zigbee network configuration to recover from device failures or coordinator changes. Off-Site Redundancy: Replace the SFTP node with a cloud storage node (e.g., Google Drive, AWS S3) for off‑site backups. Notification on Success/Failure: Add a Telegram or email node after the SFTP upload to inform you of backup completion or errors. Multiple Backup Destinations: Chain additional FTP nodes to send the backup to multiple locations. Different Schedule: Change the cron expression to run daily, or at a specific time on multiple days (e.g., for Monday and Friday).

7 nodes

Ready to automate with n8n?

Get affordable managed n8n hosting with 24/7 support.