Skip to content

v0.2.0

Choose a tag to compare

View all tags
@lehcode lehcode released this 09 Dec 15:43
· 205 commits to master since this release
Immutable release. Only release title and notes can be modified.
v0.2.0
3a6115b

Release Date: December 8, 2025

Highlights

This release introduces folder synchronization, enhanced verbose logging, and several important bug fixes. It also includes breaking changes to CLI commands.

Breaking Changes

wf remove replaced with wf delete

The workflow removal command has been renamed for clarity:

# Old (no longer works)
n8n-deploy wf remove workflow-name

# New
n8n-deploy wf delete workflow-name

server set-primary removed

The server set-primary command has been removed from the server command group.

New Features

Folder Synchronization

Bidirectional folder sync between local directories and n8n server folders:

# Authenticate with n8n server
n8n-deploy folder auth myserver --email user@example.com

# List folders on server
n8n-deploy folder list --remote myserver

# Pull workflows from n8n folder
n8n-deploy folder pull remote-folder ./local-dir

# Push workflows to n8n folder
n8n-deploy folder push ./local-dir remote-folder

# Create persistent folder mapping
n8n-deploy folder map ./workflows remote-folder --direction bidirectional

# Sync all mappings
n8n-deploy folder sync

Enhanced Verbose Logging

Two levels of verbosity for debugging HTTP operations:

# Basic verbose - shows HTTP requests
n8n-deploy -v wf push workflow-name

# Extended verbose - shows request/response details
n8n-deploy -vv wf push workflow-name

Draft Workflow Support

Create and push workflows without a server ID:

# Add workflow without ID (generates draft_xxx ID)
n8n-deploy wf add my-workflow.json --link-remote production

# Push to server (draft ID replaced with server ID)
n8n-deploy wf push draft_abc123 --remote production

Bug Fixes

  • Fixed workflow duplication on 404 errors during push
  • Fixed invalid settings fields being sent to n8n API
  • Fixed workflow active state not preserved during push
  • Fixed n8n internal API authentication and cookie handling
  • Fixed readonly fields not being stripped before API operations
  • Fixed basename matching for filename lookup (ND-50)

Database Changes

Schema upgraded to version 6 with new tables:

  • n8n_folders - n8n folder metadata
  • folder_mappings - Local-to-remote folder mappings
  • server_credentials - Server authentication credentials

Existing databases will be automatically migrated.

Requirements

  • Python 3.9+ (previously 3.8+)
  • n8n server with API access

Upgrade Instructions

  1. Update n8n-deploy:

    pip install --upgrade n8n-deploy

  2. Update any scripts using wf remove to use wf delete

  3. Database schema will migrate automatically on first run

Documentation

Contributors

Thanks to all contributors who helped with this release.

Assets 3
Loading