mirror of
https://github.com/n8n-io/n8n.git
synced 2024-09-20 06:47:32 -07:00
697efb2d31
* (no-changelog)docs: update README Update a link in the README Should we consider directing the Docker and installation links to the docs? Or are we confident the READMEs they currently link to will stay up to date? * add docs links
89 lines
3.6 KiB
Markdown
89 lines
3.6 KiB
Markdown
|
|
|
|
# n8n - Workflow automation tool
|
|
|
|
n8n is an extendable workflow automation tool. With a [fair-code](http://faircode.io) distribution model, n8n
|
|
will always have visible source code, be available to self-host, and allow you to add your own custom
|
|
functions, logic and apps. n8n's node-based approach makes it highly versatile, enabling you to connect
|
|
anything to everything.
|
|
|
|
|
|
|
|
## Demo
|
|
|
|
[:tv: A short video (< 4 min)](https://www.youtube.com/watch?v=RpjQTGKm-ok) that goes over key concepts of
|
|
creating workflows in n8n.
|
|
|
|
## Available integrations
|
|
|
|
n8n has 200+ different nodes to automate workflows. The list can be found on:
|
|
[https://n8n.io/integrations](https://n8n.io/integrations)
|
|
|
|
## Documentation
|
|
|
|
The official n8n documentation can be found under: [https://docs.n8n.io](https://docs.n8n.io)
|
|
|
|
Additional information and example workflows on the n8n.io website: [https://n8n.io](https://n8n.io)
|
|
|
|
The release notes can be found [here](https://docs.n8n.io/reference/release-notes/) and the list of breaking
|
|
changes [here](https://github.com/n8n-io/n8n/blob/master/packages/cli/BREAKING-CHANGES.md).
|
|
|
|
## Usage
|
|
|
|
- :books: Learn
|
|
[how to **use** it from the command line](https://docs.n8n.io/reference/cli-commands/)
|
|
- :whale: Learn
|
|
[how to run n8n in **Docker**](https://docs.n8n.io/hosting/installation/docker/)
|
|
|
|
## Start
|
|
|
|
Execute: `npx n8n`
|
|
|
|
## n8n cloud
|
|
|
|
Sign-up for an [n8n cloud](https://www.n8n.io/cloud/) account.
|
|
|
|
While n8n cloud and n8n are the same in terms of features, n8 cloud provides certain conveniences such as:
|
|
|
|
- Not having to set up and maintain your n8n instance
|
|
- Managed OAuth for authentication
|
|
- Easily upgrading to the newer n8n versions
|
|
|
|
## Support
|
|
|
|
If you have problems or questions go to our forum, we will then try to help you asap:
|
|
|
|
[https://community.n8n.io](https://community.n8n.io)
|
|
|
|
## Jobs
|
|
|
|
If you are interested in working for n8n and so shape the future of the project check out our
|
|
[job posts](https://apply.workable.com/n8n/)
|
|
|
|
## What does n8n mean and how do you pronounce it?
|
|
|
|
**Short answer:** It means "nodemation" and it is pronounced as n-eight-n.
|
|
|
|
**Long answer:** "I get that question quite often (more often than I expected) so I decided it is probably
|
|
best to answer it here. While looking for a good name for the project with a free domain I realized very
|
|
quickly that all the good ones I could think of were already taken. So, in the end, I chose nodemation.
|
|
'node-' in the sense that it uses a Node-View and that it uses Node.js and '-mation' for 'automation' which is
|
|
what the project is supposed to help with. However, I did not like how long the name was and I could not
|
|
imagine writing something that long every time in the CLI. That is when I then ended up on 'n8n'." - **Jan
|
|
Oberhauser, Founder and CEO, n8n.io**
|
|
|
|
## Development setup
|
|
|
|
Have you found a bug :bug: ? Or maybe you have a nice feature :sparkles: to contribute ? The
|
|
[CONTRIBUTING guide](https://github.com/n8n-io/n8n/blob/master/CONTRIBUTING.md) will help you get your
|
|
development environment ready in minutes.
|
|
|
|
## License
|
|
|
|
n8n is [fair-code](http://faircode.io) distributed under the
|
|
[**Sustainable Use License**](https://github.com/n8n-io/n8n/blob/master/packages/cli/LICENSE.md) and the
|
|
[**n8n Enterprise License**](https://github.com/n8n-io/n8n/blob/master/packages/cli/LICENSE_EE.md).
|
|
|
|
Additional information about the license model can be found in the
|
|
[docs](https://docs.n8n.io/reference/license/).
|