mirror of
https://github.com/n8n-io/n8n-docs.git
synced 2025-11-20 17:48:34 +00:00
commit
94000fa49f
@ -10,7 +10,7 @@ There are a several ways in which you can contribute to n8n, depending on your s
|
||||
- Follow us on [Twitter](https://twitter.com/n8n_io), [LinkedIn](https://www.linkedin.com/company/28491094), and [Facebook](https://www.facebook.com/n8nio/).
|
||||
- Upvote n8n on [AlternativeTo](https://alternativeto.net/software/n8n-io/) and [Alternative.me](https://alternative.me/n8n-io).
|
||||
- Add n8n to your stack on [Stackshare](https://stackshare.io/n8n).
|
||||
- Write a review about n8n on [G2](https://www.g2.com/products/n8n/reviews) and [Slant](https://www.slant.co/improve/options/37977/~n8n-review).
|
||||
- Write a review about n8n on [G2](https://www.g2.com/products/n8n/reviews), [Slant](https://www.slant.co/improve/options/37977/~n8n-review), and [Capterra](https://www.capterra.com/p/198028/n8n-io/).
|
||||
|
||||
## Help out the community 🤝
|
||||
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
|
||||
[Microsoft Dynamics CRM](https://dynamics.microsoft.com/en-us/) is a is a customer relationship management application developed by Microsoft.
|
||||
|
||||
!!! note "🔑 Credentials"
|
||||
!!! note "Credentials"
|
||||
You can find authentication information for this node [here](/integrations/credentials/microsoft/).
|
||||
|
||||
|
||||
|
||||
@ -1,10 +1,27 @@
|
||||
# CLI commands for n8n
|
||||
|
||||
n8n includes a CLI (command line interface), allowing you to perform many common actions using the CLI rather than the n8n editor. These include starting workflows, and exporting and importing workflows and credentials.
|
||||
|
||||
## Running CLI commands
|
||||
|
||||
You can use CLI commands with self-hosted n8n. Depending on how you choose to install n8n, there are differences in how to run the commands:
|
||||
|
||||
* npm: the `n8n` command is directly available. The documentation uses this in the examples below.
|
||||
* Desktop app: in the examples below, replace `n8n` with the absolute path to the `n8n.cmd` file (Windows) or the n8n Desktop executable (Mac). The exact path depends on where you install your Node.js modules. For example, to export all workflow data, the command looks similar to this:
|
||||
```sh
|
||||
# Windows
|
||||
"C:\Users\<username>\AppData\Local\Programs\n8n\resources\app\node_modules\n8n\bin\n8n.cmd" export:workflow --all
|
||||
# Mac
|
||||
/Users/<username>/Desktop/n8n.app/Contents/Resources/app/node_modules/n8n/bin/n8n export:workflow --all
|
||||
```
|
||||
* Docker: the `n8n` command is available within your Docker container. For example:
|
||||
```sh
|
||||
docker exec -it <n8n-container-name> n8n export:workflow --all
|
||||
```
|
||||
|
||||
## Start a workflow
|
||||
|
||||
Workflows can not only be started by triggers, webhooks, or manually via the Editor. It is also possible to start them directly via the CLI.
|
||||
You can start workflows directly using the CLI.
|
||||
|
||||
Execute a saved workflow by its ID:
|
||||
|
||||
@ -19,7 +36,7 @@ n8n execute --file <WORKFLOW_FILE>
|
||||
|
||||
## Change the active status of a workflow
|
||||
|
||||
You can change the active status of a workflow via the CLI.
|
||||
You can change the active status of a workflow using the CLI.
|
||||
|
||||
Set the active status of a workflow by its ID to false:
|
||||
|
||||
@ -47,15 +64,15 @@ n8n update:workflow --all --active=true
|
||||
|
||||
## Export workflows and credentials
|
||||
|
||||
You can export your workflows and credentials from n8n via the CLI.
|
||||
You can export your workflows and credentials from n8n using the CLI.
|
||||
|
||||
There are a couple of flags available for this.
|
||||
Command flags:
|
||||
|
||||
| Flag | Description |
|
||||
|-------------|-------|
|
||||
| --help | Help prompt. |
|
||||
| --all | Exports all workflows/credentials. |
|
||||
| --backup | Sets --all --pretty --separate for simple backups. Only --output has to be set additionally. |
|
||||
| --backup | Sets --all --pretty --separate for backups. You can optionally set --output. |
|
||||
| --id | The ID of the workflow to export. |
|
||||
| --output | Outputs file name or directory if using separate files. |
|
||||
| --pretty | Formats the output in an easier to read fashion. |
|
||||
@ -114,9 +131,9 @@ Export all the credentials to a specific directory using the `--backup` flag (de
|
||||
n8n export:credentials --backup --output=backups/latest/
|
||||
```
|
||||
|
||||
Export all the credentials in a decrypted (plain text) format. This can be used to migrate from one installation to another that has a different secret key (in the config file).
|
||||
Export all the credentials in a decrypted (plain text) format. You can use this to migrate from one installation to another that has a different secret key (in the config file).
|
||||
|
||||
**Note:** All sensitive information will be visible in the files.
|
||||
**Note:** All sensitive information is visible in the files.
|
||||
|
||||
```bash
|
||||
n8n export:credentials --all --decrypted --output=backups/decrypted.json
|
||||
@ -127,24 +144,24 @@ n8n export:credentials --all --decrypted --output=backups/decrypted.json
|
||||
|
||||
You can import your workflows and credentials from n8n via the CLI.
|
||||
|
||||
!!! warning " Update the IDs"
|
||||
When exporting workflows and credentials, their IDs also get exported. If you have workflows and credentials with the same IDs in your existing database, they will get overwritten. To avoid this, delete or change the IDs before importing.
|
||||
!!! warning "Update the IDs"
|
||||
When exporting workflows and credentials, n8n also exports their IDs. If you have workflows and credentials with the same IDs in your existing database, they will be overwritten. To avoid this, delete or change the IDs before importing.
|
||||
|
||||
|
||||
There are a couple of flags available for this.
|
||||
Available flags:
|
||||
|
||||
| Flag | Description |
|
||||
|-------------|-------|
|
||||
| --help | Help prompt. |
|
||||
| --input | Input file name or directory if --separate is used. |
|
||||
| --input | Input file name or directory if you use --separate. |
|
||||
| --separate | Imports *.json files from directory provided by --input. |
|
||||
|
||||
!!! warning " Migrating to different database systems"
|
||||
Workflow and credential names are limited to 128 characters, but SQLite does not enforce size limits correctly.
|
||||
!!! warning "Migrating to different database systems"
|
||||
n8n limits workflow and credential names to 128 characters, but SQLite doesn't enforce size limits correctly.
|
||||
|
||||
This might result in errors like `Data too long for column name` during the import process.
|
||||
This might result in errors like `Data too long for column name` during the import process.
|
||||
|
||||
In this case, you can edit the names from the n8n interface and export again or edit the JSON file directly before importing.
|
||||
In this case, you can edit the names from the n8n interface and export again or edit the JSON file directly before importing.
|
||||
|
||||
|
||||
|
||||
|
||||
@ -1,5 +1,49 @@
|
||||
# Release notes
|
||||
|
||||
## n8n@0.175.1
|
||||
|
||||
View the [commits](https://github.com/n8n-io/n8n/compare/n8n@0.175.0...n8n@0.175.1) for this version.<br />
|
||||
**Release date:** 2022-05-03
|
||||
|
||||
This is a bug fix release.
|
||||
|
||||
### Bug fixes
|
||||
|
||||
Fixes a bug in the editor UI related to node versioning.
|
||||
|
||||
## n8n@0.175.0
|
||||
|
||||
View the [commits](https://github.com/n8n-io/n8n/compare/n8n@0.174.0...n8n@0.175.0) for this version.<br />
|
||||
**Release date:** 2022-05-02
|
||||
|
||||
This release adds support for node versioning, along with node enhancements and bug fixes.
|
||||
|
||||
### Enhancements
|
||||
|
||||
0.175.0 adds support for a lightweight method of node versioning. One node can contain multiple versions, allowing small version increments without code duplication. To use this feature, change the `version` parameter in your node to an array, and add your version numbers, including your existing version. You can then access the version parameter with `@version` in your `displayOptions` (to control which version n8n displays). You can also query the version in your `execute` function using `const nodeVersion = this.getNode().typeVersion;`.
|
||||
|
||||
### Node enhancements
|
||||
|
||||
* [Google Sheets node](/integrations/nodes/n8n-nodes-base.googleSheets/): n8n now handles header names formatted as JSON paths.
|
||||
* [Microsoft Dynamics CRM node](/integrations/nodes/n8n-nodes-base.microsoftDynamicsCrm/): add support for regions other than North America.
|
||||
* [Telegram node](/integrations/nodes/n8n-nodes-base.telegram/): add support for querying chat administrators.
|
||||
|
||||
### Bug fixes
|
||||
|
||||
* **core**: fixed an issue that was causing n8n to apply authentication checks, even when user management was disabled.
|
||||
* **core**: n8n now skips credentials checks for disabled nodes.
|
||||
* **editor**: fix a bug affecting touchscreen monitors.
|
||||
* [HubSpot node](/integrations/nodes/n8n-nodes-base.hubspot/): fix for search operators.
|
||||
* [SendGrid node](/integrations/nodes/n8n-nodes-base.sendGrid/): fixed an issue with sending attachments.
|
||||
* [Wise node](/integrations/nodes/n8n-nodes-base.wise/): respect the time parameter on `get: exchangeRate`.
|
||||
|
||||
### Contributors
|
||||
|
||||
[Jack Rudenko](https://github.com/erudenko)
|
||||
[MC Naveen](https://github.com/mcnaveen)
|
||||
[vcrwr](https://github.com/vcrwr)
|
||||
|
||||
|
||||
## n8n@0.174.0
|
||||
|
||||
View the [commits](https://github.com/n8n-io/n8n/compare/n8n@0.173.1...n8n@0.174.0) for this version.<br />
|
||||
|
||||
Loading…
Reference in New Issue
Block a user