Duaer

Build

Merge branches in Duaer

In Duaer, Merge waits until each input has data, then appends, combines by field, runs SQL, or keeps one branch.

Pick a mode

  • Append: stack items from every input into one list, in order. Any number of inputs.
  • Combine: two inputs only. Matching fields lines rows up by a shared field name, and leaves a blank where one input has no match. Position lines rows up by order.
  • SQL Query: use this when more than two inputs need a filter or a total. The inputs are tables in the query.
  • Choose Branch: after a split, keep one input and drop the rest.

Example: line up by a field

Both inputs have id. Set Mode to Combine, Combine By to matching fields, and the field to id.

  • One input has name for id 1 and the other has city for id 1: one output item has both fields.
  • Only one input has id 2: that item is still kept, and the missing field is empty.

Merge waits until every connected input has data. If one branch never runs, later nodes do not start.

Questions

Does Merge in Duaer rewrite the original files?

No. It only builds the items later nodes use in this execution.

In this section

Flow

Handle errors gracefully in Duaer

How to handle execution errors in Duaer.

Flow

Fix memory issues in Duaer

Duaer does not restrict how much data each node can fetch. When an execution needs more memory than available, it can fail. This page explains how to identify and avoid those errors.

Flow

Use loops in Duaer

Use looping in Duaer when you want to process multiple items or repeat an action. Most nodes iterate automatically; some cases need an explicit loop.

Flow

Break work into sub-organizations in Duaer

Use Execute Sub-workflow in Duaer to split work into reusable sub-organizations. The called digital organization must start with Execute Sub-workflow Trigger.

Accounts

Manage users and access in Duaer

User management in Duaer lets you invite people to work in your instance.

Accounts

Connect LDAP to Duaer

Using LDAP with Duaer.

Accounts

Map roles for Duaer LDAP

Map directory groups to Duaer instance roles or project roles.

Accounts

Provision roles for Duaer OIDC

After OIDC sign-in works, map the provider’s groups to Duaer roles.

Accounts

Provision roles for Duaer SAML

After SAML sign-in works, map groups in the assertion to Duaer roles.

Accounts

Require two-factor auth in Duaer

How to enable 2FA for your Duaer account.

Accounts

Custom roles in Duaer

Overview of custom roles in Duaer, project-level and instance-level.

Accounts

Use external secret stores in Duaer

Use an external secrets vault with Duaer.

Hosting

Use source control and environments in Duaer

Overview of source control and environments in Duaer.

Hosting

Set up source control in Duaer

Link Duaer to your Git provider.

Hosting

Work with environments in Duaer

Understand the concepts behind environments in Duaer.

Hosting

Use Git in Duaer

Git concepts and limitations in Duaer.

Hosting

Push and pull changes in Duaer

Send work to Git, and fetch work from Git to your Duaer instance.

Hosting

Stream logs from Duaer to external systems

Stream events from Duaer to your logging tools.

Hosting

Track usage with Insights in Duaer

Duaer Insights gives instance owners and admins visibility into how digital organizations perform over time.

API

Use the Duaer public API

Call the Duaer public REST API with an API key.

API

Authentication for the Duaer public API

Duaer uses API keys to authenticate public REST API calls.

API

Endpoint reference for the Duaer public API

Endpoint reference for the Duaer public REST API on your instance. This docs site does not keep a second route list that would go stale.

Releases

Duaer changelog

Entry point for Duaer version notes. Breaking changes have their own pages.

Releases

Duaer release notes

What this Duaer version adds, and what to check on upgrade.

Releases

Duaer v3 breaking changes

Behavior that changes when you upgrade to Duaer v3.

Releases

Duaer 1.0 migration checklist

What to check when moving up from before Duaer 1.0.

Releases

Duaer 2.0 breaking changes

Behavior that changes when you upgrade to Duaer 2.0.

Hosting

Enable queue mode in Duaer

You can run Duaer in different modes depending on your needs. Queue mode provides the best scalability.

Hosting

Control concurrency in Duaer

Limit how many production executions may run at the same time on self-hosted Duaer.

Hosting

Fix memory issues on self-hosted Duaer

Memory-related errors when self-hosting Duaer: how to identify and avoid them.

Hosting

Handle binary data in Duaer

How to handle large files without degrading Duaer’s performance.

Hosting

Compare Duaer editions

Compare the self-hosted Duaer plans and editions: Community, Registered Community, Business, and Enterprise.

Hosting

Configure user management on self-hosted Duaer

Configure your self-hosted Duaer instance to support user management, and start inviting users.

Hosting

Encryption keys in Duaer

Duaer encrypts credentials before saving them to the database. It creates a key on first launch; DUAER_ENCRYPTION_KEY overrides that.

Hosting

Set a custom encryption key for Duaer

Set a custom encryption key for Duaer to securely encrypt credentials.

Hosting

Environment variables for Duaer

Configure the self-hosted Duaer process with environment variables.

Hosting

Manage Duaer settings with environment variables

Configure self-hosted Duaer from the process environment, a .env file, or container injection.

Hosting

Supported databases for Duaer

Self-hosted Duaer can use SQLite or Postgres.

Hosting

Set up task runners for Duaer

How to configure Duaer task runners to execute tasks using internal or external runner processes.

Hosting

Trace Duaer executions with OpenTelemetry

Send digital organization and node execution traces from Duaer to an OpenTelemetry collector.

Hosting

Use the Duaer command line

Commands available in the built-in Duaer command-line interface.

Hosting

Update Duaer

Best practices for updating your self-hosted Duaer.

Hosting

Run security audits on Duaer

Run a security audit on your Duaer instance.

Flow

Flow logic in Duaer

Error handling, looping, and sub-organizations. Start here for the most common canvas flow questions in Duaer.

Hosting

Configure self-hosted Duaer

Encryption keys, environment variables, databases, and task runners. Prefer Postgres in production and pin DUAER_ENCRYPTION_KEY.

Hosting

Duaer configuration examples

Copy-ready self-hosted configuration examples. Start with a custom encryption key.

Accounts

Grant execution access on a Duaer project role

In Duaer, a project role’s Executions section has View and Delete. View follows Duaer Organization View and cannot be turned on by itself.

Accounts

Read personal space on a Duaer instance role

In Duaer, every instance role lists personal-space permissions, and those checkboxes cannot be cleared on the role. What you can turn off is publishing and sharing under Security & policies.

Hosting

Find a restricted node in Duaer and replace it

In Duaer, a node blocked by policy still appears in search, and it cannot be added to the canvas. When you replace a step, the panel title is Replace this step.

Flow

Let Duaer read a Telegram photo

In Duaer, Telegram Trigger has to download images and files before a digital employee can read the photo, not only the text update.

Flow

Keep a Duaer node’s input and output visible on a narrow screen

In Duaer, after you open a node, the input panel and the output panel stay on screen when the window is narrow. There is no separate switch.

Flow

Keep a canceled Duaer execution canceled

In Duaer, an execution you cancel stays canceled. A later write does not turn it into success or error.

Get started

Choose how to use Duaer

Duaer runs on www.duaer.com, or you host it yourself with Docker. The plan sets monthly executions and AI credits.

Get started

Build your first digital organization in Duaer

In Duaer, start from an empty canvas, add a trigger and Edit Fields, run once, and confirm the output shows the current time.

Get started

Key concepts in Duaer

In Duaer a digital organization is the canvas flow, and a digital employee is the side that delivers a result. Nodes, credentials, expressions, and plans are on this page.

Plans

Duaer plans and credits

Duaer hosted billing is by execution. Hobby is free, with 1,000 executions and 800 AI credits a month. Yearly billing is about 17% less.

Manage

Save and publish a digital organization in Duaer

In Duaer, edits stay a draft until you publish. Schedules, webhooks, and production runs use the published version.

Manage

Read executions in Duaer

In Duaer, one execution is one run of a digital organization. The Executions list shows success, error, canceled, running, queued, and waiting.

Manage

Debug a past execution in Duaer

In Duaer, open a past execution and use Debug in editor to pin that run’s data on the canvas, then change a node and run again.

Flow

Split a Duaer run with If and Switch

In Duaer, If sends each item to the true or false output. Switch sends items to several outputs by rules or an expression.

Flow

Pause a Duaer execution with Wait

In Duaer, Wait pauses the execution until a time interval, a date, a webhook call, or a form submit.

Manage

Export and import a digital organization in Duaer

In Duaer, Export JSON saves the canvas and nodes. It does not include credential secrets. After import, select credentials again.

Manage

Share and tag digital organizations in Duaer

In Duaer, Share hands a digital organization to other people or a project. Tags live with the description and filter the list.

Triggers

Receive a request with Webhook in Duaer

In Duaer, Webhook starts a digital organization. The Test URL works only while you are listening. The Production URL accepts outside calls after you publish.

Triggers

Run a Duaer digital organization on a schedule

In Duaer, Schedule Trigger starts a digital organization on the interval you set. It keeps that clock only after you publish. Execute on the canvas runs once now and does not wait for the clock.

Nodes

Call an API with HTTP Request in Duaer

In Duaer, HTTP Request sends the method and URL you enter. Put the account in a credential, not in the node parameters.

Flow

Drop items with Filter in Duaer

In Duaer, Filter keeps only the items that match. Items that do not match are dropped. There is no second output for them.

Flow

Choose branch order in Duaer

In Duaer, when a digital organization splits into branches, Execution Logic decides which branch finishes first. New digital organizations use v1 (recommended).

Manage

Start from a template in Duaer

In Duaer, a template is a ready-made digital organization. Using it copies the canvas onto your instance. You select credentials here.

Data

Keep rows in a Duaer data table

In Duaer, a data table lives in the current project. Rows one digital organization writes can be read by another in the same project.

Triggers

Reply to a caller with Respond to Webhook in Duaer

In Duaer, Respond to Webhook chooses when and what a Webhook or form sends back. The Webhook in front must set Respond to Using Respond to Webhook Node.

Triggers

Collect a form submission in Duaer

In Duaer, Duaer Form Trigger builds a web form. A submission starts the digital organization, and the fields show up on the node output.

Nodes

Change fields with Edit Fields in Duaer

In Duaer, Edit Fields (Set) adds or replaces fields on each item. Use it when you only change a few fields, instead of writing Code.

Flow

Process items in batches in Duaer

In Duaer, most nodes already run once per item. Split In Batches is for a fixed batch size, with a pause between batches.