This is a Heroku-focused container implementation of n8n.
Use the Deploy to Heroku button above to launch n8n on Heroku. When deploying, make sure to check all configuration options and adjust them to your needs. It's especially important to set N8N_ENCRYPTION_KEY
to a random secure value.
Refer to the Heroku n8n tutorial for more information.
If you have questions after trying the tutorials, check out the forums.
This repo contains example nodes to help you get started building your own custom integrations for n8n. It includes the node linter and other dependencies.
To make your custom node available to the community, you must create it as an npm package, and submit it to the npm registry.
You need the following installed on your development machine:
- git
- Node.js and npm. Minimum version Node 16. You can find instructions on how to install both using nvm (Node Version Manager) for Linux, Mac, and WSL here. For Windows users, refer to Microsoft's guide to Install NodeJS on Windows.
- Install n8n with:
npm install n8n -g
- Recommended: follow n8n's guide to set up your development environment.
These are the basic steps for working with the starter. For detailed guidance on creating and publishing nodes, refer to the documentation.
- Generate a new repository from this template repository.
- Clone your new repo:
git clone https://github.com/<your organization>/<your-repo-name>.git
- Run
npm i
to install dependencies. - Open the project in your editor.
- Browse the examples in
/nodes
and/credentials
. Modify the examples, or replace them with your own nodes. - Update the
package.json
to match your details. - Run
npm run lint
to check for errors ornpm run lintfix
to automatically fix errors when possible. - Test your node locally. Refer to Run your node locally for guidance.
- Replace this README with documentation for your node. Use the README_TEMPLATE to get started.
- Update the LICENSE file to use your details.
- Publish your package to npm.
Refer to our documentation on creating nodes for detailed information on building your own nodes.