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.
Digital organization
A digital organization is the set of nodes on the canvas that finishes one job. It starts at a trigger and follows the connections. The saved record is still called a workflow in some product identifiers.
Digital employee
A digital employee is a delivery you hand to Duaer. You name the result, Duaer does the work, and you accept it. Schedules hang off a digital employee. Refer to Schedule a task for a Duaer digital employee.
Node and canvas
A node is one step: a trigger, a fetch, a transform, or a send. The canvas is where you place and connect nodes. Refer to Work with nodes in Duaer.
Credential
A credential is stored on the Duaer instance and protected by the encryption key. A node references the credential instead of putting the secret in a parameter. Refer to Create and edit credentials in Duaer.
Expression and execution
An expression fills a parameter at run time inside {{ }}, such as a field on the current item or $now. An execution is one recorded run of the digital organization. Success, error, and canceled all stay in the executions list.
Plan and AI credits
Hosted plans are Hobby, Starter, Pro, and Business. One full run of a digital organization counts as one execution. AI credits are a separate allowance for model calls. Refer to Duaer plans and credits.
Duaer orgifyDesk
Duaer orgifyDesk is the assistant on the canvas. It edits the digital organization at the nodes you name. Refer to How Duaer orgifyDesk edits a digital organization.
Questions
In Duaer, is a digital organization the same thing as a digital employee?
No. A digital organization is the flow on the canvas. A digital employee is the delivery you accept. Schedules belong to the digital employee.
In this section
Handle errors gracefully in Duaer
How to handle execution errors in Duaer.
FlowFix 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.
FlowUse 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.
FlowBreak 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.
AccountsManage users and access in Duaer
User management in Duaer lets you invite people to work in your instance.
AccountsConnect LDAP to Duaer
Using LDAP with Duaer.
AccountsMap roles for Duaer LDAP
Map directory groups to Duaer instance roles or project roles.
AccountsProvision roles for Duaer OIDC
After OIDC sign-in works, map the provider’s groups to Duaer roles.
AccountsProvision roles for Duaer SAML
After SAML sign-in works, map groups in the assertion to Duaer roles.
AccountsRequire two-factor auth in Duaer
How to enable 2FA for your Duaer account.
AccountsCustom roles in Duaer
Overview of custom roles in Duaer, project-level and instance-level.
AccountsUse external secret stores in Duaer
Use an external secrets vault with Duaer.
HostingUse source control and environments in Duaer
Overview of source control and environments in Duaer.
HostingSet up source control in Duaer
Link Duaer to your Git provider.
HostingWork with environments in Duaer
Understand the concepts behind environments in Duaer.
HostingUse Git in Duaer
Git concepts and limitations in Duaer.
HostingPush and pull changes in Duaer
Send work to Git, and fetch work from Git to your Duaer instance.
HostingStream logs from Duaer to external systems
Stream events from Duaer to your logging tools.
HostingTrack usage with Insights in Duaer
Duaer Insights gives instance owners and admins visibility into how digital organizations perform over time.
APIUse the Duaer public API
Call the Duaer public REST API with an API key.
APIAuthentication for the Duaer public API
Duaer uses API keys to authenticate public REST API calls.
APIEndpoint 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.
ReleasesDuaer changelog
Entry point for Duaer version notes. Breaking changes have their own pages.
ReleasesDuaer release notes
What this Duaer version adds, and what to check on upgrade.
ReleasesDuaer v3 breaking changes
Behavior that changes when you upgrade to Duaer v3.
ReleasesDuaer 1.0 migration checklist
What to check when moving up from before Duaer 1.0.
ReleasesDuaer 2.0 breaking changes
Behavior that changes when you upgrade to Duaer 2.0.
HostingEnable queue mode in Duaer
You can run Duaer in different modes depending on your needs. Queue mode provides the best scalability.
HostingControl concurrency in Duaer
Limit how many production executions may run at the same time on self-hosted Duaer.
HostingFix memory issues on self-hosted Duaer
Memory-related errors when self-hosting Duaer: how to identify and avoid them.
HostingHandle binary data in Duaer
How to handle large files without degrading Duaer’s performance.
HostingCompare Duaer editions
Compare the self-hosted Duaer plans and editions: Community, Registered Community, Business, and Enterprise.
HostingConfigure user management on self-hosted Duaer
Configure your self-hosted Duaer instance to support user management, and start inviting users.
HostingEncryption keys in Duaer
Duaer encrypts credentials before saving them to the database. It creates a key on first launch; DUAER_ENCRYPTION_KEY overrides that.
HostingSet a custom encryption key for Duaer
Set a custom encryption key for Duaer to securely encrypt credentials.
HostingEnvironment variables for Duaer
Configure the self-hosted Duaer process with environment variables.
HostingManage Duaer settings with environment variables
Configure self-hosted Duaer from the process environment, a .env file, or container injection.
HostingSupported databases for Duaer
Self-hosted Duaer can use SQLite or Postgres.
HostingSet up task runners for Duaer
How to configure Duaer task runners to execute tasks using internal or external runner processes.
HostingTrace Duaer executions with OpenTelemetry
Send digital organization and node execution traces from Duaer to an OpenTelemetry collector.
HostingUse the Duaer command line
Commands available in the built-in Duaer command-line interface.
HostingUpdate Duaer
Best practices for updating your self-hosted Duaer.
HostingRun security audits on Duaer
Run a security audit on your Duaer instance.
FlowFlow logic in Duaer
Error handling, looping, and sub-organizations. Start here for the most common canvas flow questions in Duaer.
HostingConfigure self-hosted Duaer
Encryption keys, environment variables, databases, and task runners. Prefer Postgres in production and pin DUAER_ENCRYPTION_KEY.
HostingDuaer configuration examples
Copy-ready self-hosted configuration examples. Start with a custom encryption key.
AccountsGrant 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.
AccountsRead 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.
HostingFind 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.
FlowLet 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.
FlowKeep 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.
FlowKeep 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 startedChoose 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 startedBuild 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.
PlansDuaer 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.
ManageSave 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.
ManageRead 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.
ManageDebug 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.
FlowSplit 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.
FlowMerge branches in Duaer
In Duaer, Merge waits until each input has data, then appends, combines by field, runs SQL, or keeps one branch.
FlowPause a Duaer execution with Wait
In Duaer, Wait pauses the execution until a time interval, a date, a webhook call, or a form submit.
ManageExport 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.
ManageShare 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.
TriggersReceive 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.
TriggersRun 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.
NodesCall 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.
FlowDrop 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.
FlowChoose 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).
ManageStart 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.
DataKeep 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.
TriggersReply 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.
TriggersCollect 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.
NodesChange 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.
FlowProcess 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.