No history yet

Introduction to n8n

What is n8n?

Think of your daily digital tasks. You get an email, so you copy a detail from it into a spreadsheet. Then you send a chat message to a coworker to let them know. Each step is simple, but together they take time and focus. Workflow automation tools handle these multi-step tasks for you automatically.

n8n is a source-available AI-native workflow automation platform that empowers you to connect various apps and services to automate tasks and processes.

At its heart, n8n works with three core concepts:

  • Nodes: These are the building blocks of your automation. Each node represents an app (like Gmail or Slack) or an action (like waiting, filtering data, or running code).
  • Connections: These are the lines you draw between nodes. They dictate the flow of data, telling n8n where to send information from one step to the next.
  • Workflows: A workflow is the complete chain of nodes and connections on your screen, representing the entire process you've automated. It’s the full recipe, from start to finish.
Lesson image

Getting Started

You can use n8n in two main ways. The easiest is n8n Cloud, which handles all the setup for you. For more control, you can host it yourself. A popular self-hosting method uses Docker, a tool that runs applications in isolated environments called containers.

If you have Docker installed, you can get a local n8n instance running with a single command in your terminal.

docker run -it --rm \
--name n8n \
-p 5678:5678 \
-v ~/.n8n:/home/node/.n8n \
n8nio/n8n

Once it's running, you can access your n8n editor by opening a web browser and navigating to http://localhost:5678. From there, you'll create an owner account and you're ready to start building.

Exploring the Canvas

When you create a new workflow, you'll see the n8n editor, which we call the Canvas. This is your workspace for building automations. It might look like a lot at first, but it's organized into a few key areas.

  • The Canvas: The large central area where you'll drag and connect nodes to visualize your workflow.
  • Nodes Panel: On the left, this is where you'll find all available nodes. You can search for an app or a function and drag it onto the canvas.
  • Parameters Panel: When you select a node on the canvas, this panel appears on the right. It's where you configure the node's settings, like entering credentials or specifying what data to use.
  • Execution Log: After you run a workflow, a log appears at the bottom showing the results of each step, which is essential for checking your work and fixing any issues.

Building a Basic Workflow

Let's build something simple to see how it works. Our goal is to create a workflow that starts manually, creates a piece of text, and displays it.

  1. Every new workflow starts with a Start node. This is your trigger. By default, it's set to run manually when you click the 'Execute Workflow' button.

  2. Click the + button to the right of the Start node. A menu will pop up. Search for the Set node and select it. The Set node is a simple but powerful tool for creating, modifying, or formatting data.

  3. Now, select the Set node you just added. The Parameters Panel will open on the right. Under 'Value', type in a message like Hello, n8n!.

  4. Make sure the 'Keep Only Set' option is turned on. This tells the node to only pass along the values we just defined.

Your canvas should now show two nodes: Start connected to Set.

Now for the fun part. In the top right corner of the editor, click the 'Execute Workflow' button. The workflow will run, and you'll see green checkmarks on each node. Click on the Set node, and in the Execution Log at the bottom, you'll see the output. It should display the message you created.

Congratulations! You've just built and executed your first n8n workflow. You've seen how to add nodes, configure them, and watch data flow from one step to the next.

Quiz Questions 1/5

In n8n, what are the building blocks that represent apps or actions like filtering data?

Quiz Questions 2/5

Where in the n8n editor would you configure a node's settings, such as entering credentials or specifying what data to use?

This is just the beginning. The real power of n8n comes from connecting many different nodes to automate complex, real-world tasks.