Flow, accounts, and hosting

Configure self-hosted Duaer

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

Configuration entry points

Encryption keys: credentials are encrypted at rest; every queue-mode worker needs the same key.
Environment variables: process env, `.env`, or container injection.
Supported databases: SQLite or Postgres.
Task runners: internal or external runners.
Configuration examples: copy-ready setups.

Questions

What should I configure first on self-hosted Duaer?

The encryption key, the database (Postgres in production), and the environment variables you will change. In queue mode every worker must share the same encryption key.

In this section

Handle errors gracefully in Duaer

How to handle execution errors in Duaer.

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.

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.

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.

Manage users and access in Duaer

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

Connect LDAP to Duaer

Using LDAP with Duaer.

Map roles for Duaer LDAP

Map directory groups to Duaer instance roles or project roles.

Provision roles for Duaer OIDC

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

Provision roles for Duaer SAML

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

Require two-factor auth in Duaer

How to enable 2FA for your Duaer account.

Custom roles in Duaer

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

Use external secret stores in Duaer

Use an external secrets vault with Duaer.

Use source control and environments in Duaer

Overview of source control and environments in Duaer.

Set up source control in Duaer

Link Duaer to your Git provider.

Work with environments in Duaer

Understand the concepts behind environments in Duaer.

Use Git in Duaer

Git concepts and limitations in Duaer.

Push and pull changes in Duaer

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

Stream logs from Duaer to external systems

Stream events from Duaer to your logging tools.

Track usage with Insights in Duaer

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

Use the Duaer public API

Call the Duaer public REST API with an API key.

Authentication for the Duaer public API

Duaer uses API keys to authenticate public REST API calls.

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.

Duaer changelog

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

Duaer release notes

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

Duaer v3 breaking changes

Behavior that changes when you upgrade to Duaer v3.

Duaer 1.0 migration checklist

What to check when moving up from before Duaer 1.0.

Duaer 2.0 breaking changes

Behavior that changes when you upgrade to Duaer 2.0.

Enable queue mode in Duaer

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

Control concurrency in Duaer

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

Fix memory issues on self-hosted Duaer

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

Handle binary data in Duaer

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

Compare Duaer editions

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

Configure user management on self-hosted Duaer

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

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.

Set a custom encryption key for Duaer

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

Environment variables for Duaer

Configure the self-hosted Duaer process with environment variables.

Manage Duaer settings with environment variables

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

Supported databases for Duaer

Self-hosted Duaer can use SQLite or Postgres.

Set up task runners for Duaer

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

Trace Duaer executions with OpenTelemetry

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

Use the Duaer command line

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

Update Duaer

Best practices for updating your self-hosted Duaer.

Run security audits on Duaer

Run a security audit on your Duaer instance.

Flow logic in Duaer

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

Duaer configuration examples

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