n8n Docs
This repository hosts the documentation for n8n, an extendable workflow automation tool which enables you to connect anything to everything. The documentation is live at docs.n8n.io.
Previewing and building the documentation locally
Prerequisites
- Python 3.8 or above
- Pip
- n8n recommends using a virtual environment when working with Python, such as venv.
- Follow the recommended configuration and auto-complete guidance for the theme. This will help when working with the
mkdocs.ymlfile. - The repo includes a
.editorconfigfile. Make sure your local editor settings do not override these settings. In particular:- Don't allow your editor to replace tabs with spaces. This can affect our code samples (which must retain tabs for people building nodes).
- One tab must be equivalent to four spaces.
Steps
For members of the n8n GitHub organization:
-
Set up an SSH token and add it to your GitHub account. Refer to GitHub | About SSH for guidance.
-
Then run these commands:
git clone --recurse-submodules [email protected]:n8n-io/n8n-docs.git cd n8n-docs pip install -r requirements.txt pip install _submodules/insiders
For external contributors:
Rely on the preview builds on pull requests, or use the free version of Material for MkDocs (most things are the same, some formatting may be missing)
Fork the repository, then:
git clone https://github.com/<your-username>/n8n-docs.git
cd n8n-docs
pip install -r requirements.txt
pip install mkdocs-material
To serve a local preview:
mkdocs serve
Contributing
Please read the CONTRIBUTING guide.
You can find style guidance in the wiki.
Support
If you have problems or questions, head to n8n's forum: https://community.n8n.io
License
n8n-docs is fair-code licensed under the Sustainable Use License.
More information about the license is available in the License documentation.