Build a Local Automation Enviroment: Self-Hosted n8n + Node.js API with Docker Compose 🐳

When building a workflow automation system, using n8n can be highly beneficial due to its powerful open-source nature. However, using third-party APIs or cloud instances can lead to issues such as latency, rate limits, and privacy concerns. To address these issues, one can create a self-hosted, cloud-native architecture.

In this tutorial, the author demonstrates how to set up a local development environment that integrates n8n and a custom Node.js REST API via a Docker bridge network. This setup offers two primary benefits: enhanced security by keeping services separate but still allowing internal communication, and portability, making it easy to deploy to a VPS like Civo, DigitalOcean, or AWS.

The first step involves creating a Node.js API. This is done by setting up an Express server with a simple endpoint to return test data. The API is then containerized using a lightweight Dockerfile based on the Node.js Alpine image. The Dockerfile builds the Node.js application and exposes the necessary port.

The second step involves using Docker Compose to orchestrate both the n8n and the custom Node.js API. The docker-compose.yml file defines the services, their ports, and the network they should be connected to. The n8n service uses the official n8n Docker image, while the API service is built from the custom Dockerfile defined earlier. Both services are connected to a shared Docker bridge network, allowing them to communicate securely.

To run the environment, navigate to the project directory in your terminal and execute the command `docker compose up -d --build`. This command runs the services in the background and compiles the custom Node.js image with the latest changes. Once the services are up, access the n8n dashboard at `https://localhost:5678` and test the backend API at `https://localhost:3000/api/data`.

The tutorial concludes by highlighting the benefits of this setup, including the elimination of platform-specific configuration issues, global dependency conflicts, and Node.js version mismatches. The complete source code for this project is available on GitHub at https://github.com/WhoIsMarce/proyecto-n8n-nodejs.git. The author invites readers to share their experiences with n8n and local APIs in the comments section.