n8n Sync - Releases

The first stable release. The version number is the point: the mirror is properly two-way now, and the parts that were half-built are either finished or gone rather than left to be discovered. Tags are a single set shared across n8n, the file, and Nextcloud's own searchable pills — change them wherever you happen to be. Workflow files carry n8n's real timestamps, so Recent and Popular files finally tell the truth about your automation. The trash means the same thing on both sides, in a Team Folder as much as at home. This release also removes more than any before it, and renames every workflow file on disk — read Upgrading first.

⚠️ Upgrading

• Workflow files are now named .n8n, not .n8n.json. Every existing workflow file is renamed for you on upgrade, wherever it lives — including files sitting outside a mapped folder. Your upgrade will not fail over one it cannot rename; a file left behind simply looks like an ordinary document the app ignores, so rename it to .n8n yourself and it reconnects to its workflow, with nothing lost. Outside Nextcloud, a .n8n file needs telling once which editor opens it.
• Nextcloud 32–34. The minimum is now 32, and 34 is supported.
• Three features were removed — the mode pills, the n8n:ignore tag, and the purge button. Each has a replacement or is handled for you on upgrade; see Removed.

Added

• Tags are one set across n8n, the Nextcloud pills, and the file's own tags array — change any of the three and the other two follow, with no "Sync to n8n" click. Add one by name alone and n8n fills in the id for you.
• Tags keep up outside a mapped folder too, so they survive a move or a copy — and a file that arrives already tagged keeps those tags when it becomes a workflow.
• A link mapping mirrors tags one way, so a pointer is searchable too.
• A workflow file now carries the workflow's own created and modified dates, not the sync's — so Recent, Popular files, and sorting a folder by date all mean something.
• The Nextcloud trash now mirrors n8n's archive in both directions: archiving a workflow trashes its file, unarchiving brings it back out, and deleting it for good clears the trashed file. An archived workflow used to sit in your folder as though it were live.
• Archiving a workflow in n8n removes its link file outright, with no trash entry — there is nothing to restore a pointer to, because the workflow itself is fine.
• Restoring a workflow file from a Team Folder's trash now unarchives its workflow in n8n; only the personal trash ever did, so the file came back while the workflow stayed hidden.
• Moving a workflow file straight from one mapped folder to another now rebinds it to the folder it landed in, Team Folders included; it used to be refused, telling you to move it out and back in by hand.
• A copy is named once: the filename, the JSON name and the n8n name all say Fleet Health (1). Workflows in one mapping may share a name, and their files take a numbered suffix and keep it.
• A bulk "Sync from n8n" now says how many files it removed.
• occ n8n_sync:set-groups changes the groups a mapped folder is shared with.

Changed

• A release-readiness refactor pass: dead code from retired features removed across the app and its test suite, duplicated logic merged, and every stale docblock corrected — no behaviour changed.
• BREAKING: workflow files are named .n8n, not .n8n.json — see Upgrading.
• BREAKING: requires Nextcloud 32 (was 30) and supports up to 34.
• BREAKING: deleting a link file is refused with a message instead of quietly stripping the workflow's mapping tag in n8n. Deleting one file for yourself should not un-map a workflow for everybody.
• BREAKING: moving or copying a link, or moving or copying anything into a link-mode folder, is refused with a message. A link could previously be moved into another mapping, which silently changed its mode.
• Removing the tag that maps a workflow now takes it out of the mapping. The file leaves Nextcloud and the workflow stays in n8n with only that tag removed — nothing is deleted and nothing is archived. Previously the tag was silently put back.
• BREAKING: a mapping is immutable except for its groups. Remove it and add it again to change one.
• A new mapping defaults to an admin-owned folder, not a Team Folder.
• A mapping's mode defaults to link when you don't set one, instead of the mapping being refused.
• A mapped folder appears as soon as you save the mapping, and one that cannot be provisioned is not saved at all.
• The groups a mapped folder is shared with are read from the folder, so sharing it anywhere shows up here.
• A link mapping's folder is no longer read-only.
• The Instance card shows whether an API key is already stored, and Test connection tells a missing key apart from a rejected one.
• Syncing a workflow's tags is faster.
• The admin settings say the same things in about a quarter fewer words.

Removed

• The "when you save a workflow file" timing option is gone. Nextcloud → n8n writeback now runs in the background where that works and during the save where it does not, decided per instance. Nothing to configure, and no setting to get wrong.
• BREAKING: the n8n:sync / n8n:link / n8n:unmapped pills are gone. The mapping decides a file's mode and the file still shows you what it is, so the pills were a second copy nobody could edit. They are deleted on upgrade and disappear from the tag picker.
• BREAKING: the n8n:ignore tag is gone. Move a file out of its mapped folder to keep it in Nextcloud only, or drop the mapping tag to keep it in n8n only. Files currently marked ignored become ordinary workflow files again on the next sync.
• BREAKING: the admin "Purge Nextcloud files" button is gone, along with occ n8n_sync:purge. It deleted every mirrored file in one click on the promise that a sync would bring them back — which was only true for files that were faithful mirrors, and the ones that were not are exactly the ones you would miss. Removing a mapping still cleans up its own files.
• BREAKING: writeback via webhook is gone — the Webhook settings card, the webhook path and token, and the "Test webhook" button. It was never finished and never tested, but the form still asked for a path and a token, so it read like a feature that worked. Saving a workflow file writes it back over the REST API, which is what it always actually did. The idea is worth having and is recorded for a later version.
• BREAKING: the "Write back via the REST API" checkbox is gone. It existed to let you turn one of two channels off; with one channel, turning it off just meant saving a file silently did nothing.
• A link file can no longer be opened in the text editor.

Fixed

• Saving an edit to a workflow file reaches n8n again.
• Copying a workflow file in a mapped folder makes the new workflow in n8n again; any workflow with a node was left as an untracked file beside the original.
• A copy made beside its source is no longer invisible to the app — it had no workflow in n8n and did nothing on click.
• The scheduled sync now keeps to its interval; a mapped folder could take twenty minutes to see a change.
• Scheduled n8n → Nextcloud sync can be turned on again — the checkbox now saves.
• A sync no longer marks every workflow file as modified.
• Emptying the trash now really deletes the workflow in n8n.
• Emptying a Team Folder's trash now deletes the workflow in n8n, instead of leaving it archived for good.
• Restoring a file whose workflow was deleted in n8n while it sat in the trash now creates the workflow again.
• The mapping Mode help no longer offers a "Backup" mode — there has not been one since 0.1.3.
• The Sync Actions panel no longer prints an internal note next to a run that succeeded, where a stale one could sit for months.
• The admin "Test connection" button is CSRF-protected.
• Saving a workflow file now reaches n8n on instances where background jobs only run when someone visits a page — the Nextcloud default. The push was queued and could sit unrun indefinitely.
• Answering "keep the new version" when a workflow file replaces one already in a mapped folder no longer archives the workflow you kept, and no longer leaves a second workflow behind in n8n — the file that lands keeps the workflow that was already there and simply gives it new contents.
• Moving a workflow file back into a mapped folder now sends up any changes made to it while it was outside; edits made outside a mapping were quietly overwritten by the next scheduled sync.

The first stable release. The version number is the point: the mirror is properly two-way now, and the parts that were half-built are either finished or gone rather than left to be discovered. Tags are a single set shared across n8n, the file, and Nextcloud's own searchable pills — change them wherever you happen to be. Workflow files carry n8n's real timestamps, so Recent and Popular files finally tell the truth about your automation. The trash means the same thing on both sides, in a Team Folder as much as at home. This release also removes more than any before it, and renames every workflow file on disk — read Upgrading first.

⚠️ Upgrading

• Workflow files are now named .n8n, not .n8n.json. Every existing workflow file is renamed for you on upgrade, wherever it lives — including files sitting outside a mapped folder. Your upgrade will not fail over one it cannot rename; a file left behind simply looks like an ordinary document the app ignores, so rename it to .n8n yourself and it reconnects to its workflow, with nothing lost. Outside Nextcloud, a .n8n file needs telling once which editor opens it.
• Nextcloud 32–34. The minimum is now 32, and 34 is supported.
• Three features were removed — the mode pills, the n8n:ignore tag, and the purge button. Each has a replacement or is handled for you on upgrade; see Removed.

Added

• Tags are one set across n8n, the Nextcloud pills, and the file's own tags array — change any of the three and the other two follow, with no "Sync to n8n" click. Add one by name alone and n8n fills in the id for you.
• Tags keep up outside a mapped folder too, so they survive a move or a copy — and a file that arrives already tagged keeps those tags when it becomes a workflow.
• A link mapping mirrors tags one way, so a pointer is searchable too.
• A workflow file now carries the workflow's own created and modified dates, not the sync's — so Recent, Popular files, and sorting a folder by date all mean something.
• The Nextcloud trash now mirrors n8n's archive in both directions: archiving a workflow trashes its file, unarchiving brings it back out, and deleting it for good clears the trashed file. An archived workflow used to sit in your folder as though it were live.
• Archiving a workflow in n8n removes its link file outright, with no trash entry — there is nothing to restore a pointer to, because the workflow itself is fine.
• Restoring a workflow file from a Team Folder's trash now unarchives its workflow in n8n; only the personal trash ever did, so the file came back while the workflow stayed hidden.
• Moving a workflow file straight from one mapped folder to another now rebinds it to the folder it landed in, Team Folders included; it used to be refused, telling you to move it out and back in by hand.
• A copy is named once: the filename, the JSON name and the n8n name all say Fleet Health (1). Workflows in one mapping may share a name, and their files take a numbered suffix and keep it.
• A bulk "Sync from n8n" now says how many files it removed.
• occ n8n_sync:set-groups changes the groups a mapped folder is shared with.

Changed

• A release-readiness refactor pass: dead code from retired features removed across the app and its test suite, duplicated logic merged, and every stale docblock corrected — no behaviour changed.
• BREAKING: workflow files are named .n8n, not .n8n.json — see Upgrading.
• BREAKING: requires Nextcloud 32 (was 30) and supports up to 34.
• BREAKING: deleting a link file is refused with a message instead of quietly stripping the workflow's mapping tag in n8n. Deleting one file for yourself should not un-map a workflow for everybody.
• BREAKING: moving or copying a link, or moving or copying anything into a link-mode folder, is refused with a message. A link could previously be moved into another mapping, which silently changed its mode.
• Removing the tag that maps a workflow now takes it out of the mapping. The file leaves Nextcloud and the workflow stays in n8n with only that tag removed — nothing is deleted and nothing is archived. Previously the tag was silently put back.
• BREAKING: a mapping is immutable except for its groups. Remove it and add it again to change one.
• A new mapping defaults to an admin-owned folder, not a Team Folder.
• A mapping's mode defaults to link when you don't set one, instead of the mapping being refused.
• A mapped folder appears as soon as you save the mapping, and one that cannot be provisioned is not saved at all.
• The groups a mapped folder is shared with are read from the folder, so sharing it anywhere shows up here.
• A link mapping's folder is no longer read-only.
• The Instance card shows whether an API key is already stored, and Test connection tells a missing key apart from a rejected one.
• Syncing a workflow's tags is faster.
• The admin settings say the same things in about a quarter fewer words.

Removed

• The "when you save a workflow file" timing option is gone. Nextcloud → n8n writeback now runs in the background where that works and during the save where it does not, decided per instance. Nothing to configure, and no setting to get wrong.
• BREAKING: the n8n:sync / n8n:link / n8n:unmapped pills are gone. The mapping decides a file's mode and the file still shows you what it is, so the pills were a second copy nobody could edit. They are deleted on upgrade and disappear from the tag picker.
• BREAKING: the n8n:ignore tag is gone. Move a file out of its mapped folder to keep it in Nextcloud only, or drop the mapping tag to keep it in n8n only. Files currently marked ignored become ordinary workflow files again on the next sync.
• BREAKING: the admin "Purge Nextcloud files" button is gone, along with occ n8n_sync:purge. It deleted every mirrored file in one click on the promise that a sync would bring them back — which was only true for files that were faithful mirrors, and the ones that were not are exactly the ones you would miss. Removing a mapping still cleans up its own files.
• BREAKING: writeback via webhook is gone — the Webhook settings card, the webhook path and token, and the "Test webhook" button. It was never finished and never tested, but the form still asked for a path and a token, so it read like a feature that worked. Saving a workflow file writes it back over the REST API, which is what it always actually did. The idea is worth having and is recorded for a later version.
• BREAKING: the "Write back via the REST API" checkbox is gone. It existed to let you turn one of two channels off; with one channel, turning it off just meant saving a file silently did nothing.
• A link file can no longer be opened in the text editor.

Fixed

• Saving an edit to a workflow file reaches n8n again.
• Copying a workflow file in a mapped folder makes the new workflow in n8n again; any workflow with a node was left as an untracked file beside the original.
• A copy made beside its source is no longer invisible to the app — it had no workflow in n8n and did nothing on click.
• The scheduled sync now keeps to its interval; a mapped folder could take twenty minutes to see a change.
• Scheduled n8n → Nextcloud sync can be turned on again — the checkbox now saves.
• A sync no longer marks every workflow file as modified.
• Emptying the trash now really deletes the workflow in n8n.
• Emptying a Team Folder's trash now deletes the workflow in n8n, instead of leaving it archived for good.
• Restoring a file whose workflow was deleted in n8n while it sat in the trash now creates the workflow again.
• The mapping Mode help no longer offers a "Backup" mode — there has not been one since 0.1.3.
• The Sync Actions panel no longer prints an internal note next to a run that succeeded, where a stale one could sit for months.
• The admin "Test connection" button is CSRF-protected.
• Saving a workflow file now reaches n8n on instances where background jobs only run when someone visits a page — the Nextcloud default. The push was queued and could sit unrun indefinitely.
• Answering "keep the new version" when a workflow file replaces one already in a mapped folder no longer archives the workflow you kept, and no longer leaves a second workflow behind in n8n — the file that lands keeps the workflow that was already there and simply gives it new contents.
• Moving a workflow file back into a mapped folder now sends up any changes made to it while it was outside; edits made outside a mapping were quietly overwritten by the next scheduled sync.

Fixed

• Security: bumped guzzlehttp/guzzle (integration-test dependency) to 7.15.1 and brace-expansion (transitive lint dependency) to 2.1.2/5.0.7, clearing all open Dependabot alerts.
• Cleared two open Psalm findings in N8nClient (a redundant pagination-cursor check; the shared request helper's body type widened for setWorkflowTags's list-shaped payload).

Fixed

• Security: bumped guzzlehttp/guzzle (integration-test dependency) to 7.15.1 and brace-expansion (transitive lint dependency) to 2.1.2/5.0.7, clearing all open Dependabot alerts.
• Cleared two open Psalm findings in N8nClient (a redundant pagination-cursor check; the shared request helper's body type widened for setWorkflowTags's list-shaped payload).