workflowengineby Optimajet · since 2014

Page last updated

Download Workflow Engine

Workflow Engine by Optimajet ships as NuGet packages for .NET and npm packages for the designer UI. Install Workflow Engine Free in minutes, with no registration and no license key.

v22.1.0 · August 2026Release notes

Two packages and you are running

The engine is the core runtime package plus one database provider. Add both from NuGet, then follow the integration guide to register the runtime in your application.

# the runtime
dotnet add package WorkflowEngine.NETCore-Core --version 22.1.0

# plus one persistence provider, e.g. PostgreSQL
dotnet add package WorkflowEngine.NETCore-ProviderForPostgreSQL --version 22.1.0

Database provider packages

Six providers cover the supported databases. Every package links to its NuGet page.

DatabaseNuGet packageVersionRuns on
SQL Server, Azure SQLWorkflowEngine.NETCore-ProviderForMSSQLv22.1.0.NET Framework 4.6.2+ and all modern .NET
PostgreSQLWorkflowEngine.NETCore-ProviderForPostgreSQLv22.1.0.NET Framework 4.6.2+ and all modern .NET
MySQLWorkflowEngine.NETCore-ProviderForMySQLv22.1.0.NET Framework 4.6.2+ and all modern .NET
MongoDB, Azure Cosmos DBWorkflowEngine.NETCore-ProviderForMongoDBv22.1.0.NET Framework 4.6.2+ and all modern .NET
OracleWorkflowEngine.NETCore-ProviderForOraclev22.1.0.NET Core 3.0 and later
SQLiteWorkflowEngine.NETCore-ProviderForSQLitev22.1.0.NET 8 and laterFor evaluation. Not recommended for production use.

Designer packages for your front end

Workflow Designer is a JavaScript component you embed in your web app. Three npm packages cover vanilla JavaScript, React, and Angular. Vue and Blazor work too, without a dedicated package: Vue loads the vanilla package, shown with a running sample on the JavaScript workflow designer page, React renders the wrapper component, shown with a running sample on the React workflow designer page, and Blazor embeds the designer through IJSRuntime interop, shown file by file on the Blazor workflow designer page. Integration details for every framework are on the workflow designer page.

Source code access

Licensed engine-source access is unavailable on Team and NEO Subscription. It is a one-year add-on on Complete, NEO Business and NEO SaaS, and included for one year with NEO Enterprise, under a commercial EULA. Evaluate through the NuGet packages and a trial key first.

One install, three products

You start with the same Core and database-provider packages whichever embedded product you choose. Workflow Engine Free needs no key. Workflow Engine and the separate Workflow Engine NEO product have their own editions and licenses. Add optional packages only for the Workflow Engine NEO capabilities you adopt.

Start here

Workflow Engine Free

Learning the engine, evaluation and proof-of-concept work within the documented usage limits, under a personal, non-commercial license. Commercial use, internal tools included, needs a paid product and edition.

What you install
The two NuGet packages above, nothing else.
License key
None. Install and run, no registration.
What Workflow Engine Free includes

Then

Workflow Engine

Production use past the Workflow Engine Free limits, without the capabilities of Workflow Engine NEO.

What you install
The same two packages, unchanged.
License key
A commercial key, or a trial key while you evaluate. Register it before the runtime starts.
What the full library adds

When you need it

Workflow Engine NEO

Data API, RPC API, full multitenancy, or the Forms Plugin, all licensed since v19.

What you install
The same Core and provider packages. Add Workflow Engine NEO packages only for the capabilities you adopt.
License key
A NEO key in WorkflowRuntime. If you add the HTTP API, provide it in the API options too. Without it the API still serves the Designer and the readiness and liveness probes; the Data API and the RPC API need the key.
What Workflow Engine NEO adds for SaaS
// Workflow Engine Free: nothing to register, the free feature set is active.

// Workflow Engine or Workflow Engine NEO: register the key before the runtime starts.
WorkflowRuntime.RegisterLicense("TRIAL-...");

// Workflow Engine HTTP API: if you install it, the same key goes into its options.
// Without a NEO key, Designer and health remain; Data, Search, and RPC stay disabled.
options.LicenseKey = "TRIAL-...";

Moving up keeps everything you built

Workflow Engine Free, Workflow Engine, and Workflow Engine NEO use the same Core packages. Your schemes, the process data already in your database, and the C# you wrote around the runtime carry over untouched. Going from Workflow Engine Free to Workflow Engine is registering a key. For an existing application on the same product version, moving from Workflow Engine to Workflow Engine NEO requires only registering the Workflow Engine NEO license key. Add optional packages later as you adopt those capabilities. There is nothing to re-model and no scheme migration.

Compare the products feature by feature

When you need a trial key

Never for Workflow Engine Free. Ask for a trial key when you want to test the paid feature set before buying, or when you need the Workflow Engine HTTP API, which does not start without a key. Trial keys carry a TRIAL- prefix, commercial keys carry your company name, and a key is bound to the machine it runs on.

Common questions

What .NET teams ask before the first install: which packages they need, which product and edition they end up running, and what a move to a paid product costs them.

  1. Do I need a license key to install Workflow Engine?

    No. You can install all packages without a key, and Workflow Engine Free runs without registration. To evaluate the paid products, register a trial key; to run Workflow Engine or Workflow Engine NEO commercially, register the applicable commercial key.

  2. Which NuGet packages do I need?

    Two. The core runtime package WorkflowEngine.NETCore-Core and one database provider package, for example WorkflowEngine.NETCore-ProviderForPostgreSQL. Six providers cover SQL Server, PostgreSQL, MySQL, Oracle, MongoDB, and SQLite.

  3. Does Workflow Engine run on .NET Framework?

    Yes. NuGet reports the current core package as compatible with .NET Framework 4.6.1 through 4.8.1. The package ships .NET Standard 2.0 assets. Database providers can target a narrower framework set, so use the NuGet link in the package table for the provider you choose.

  4. Do I download a different Core package for Workflow Engine Free, Workflow Engine, or Workflow Engine NEO?

    No. All three embedded products use the same Core and database-provider packages. For an existing application on the same product version, moving from Workflow Engine to Workflow Engine NEO requires only registering the Workflow Engine NEO license key. Existing schemes and Workflow Runtime integration continue; add optional Workflow Engine NEO packages only as you adopt those capabilities.

  5. Do I lose my work when moving from Workflow Engine Free to a paid product?

    No. Schemes, the process data already in your database, and your Workflow Runtime integration carry over unchanged. Moving to a paid product starts with registering its license key. For an existing application on the same product version, moving from Workflow Engine to Workflow Engine NEO requires only registering the Workflow Engine NEO license key; adopt Workflow Engine NEO capabilities gradually.

  6. Can I download the source code?

    Licensed engine-source access is unavailable on Team and NEO Subscription, a one-year add-on on Complete, NEO Business and NEO SaaS, and included for one year with NEO Enterprise, under a commercial EULA. Day-to-day distribution is through the NuGet and npm packages.

  7. How do I update to a new version?

    Update the NuGet packages to the new version and read the release notes first. Major releases can include breaking changes and mandatory database migrations, as version 22.0.0 did.

From install to a running workflow

Three steps take you from an empty project to an evaluated engine. Each step links the guide that walks you through it.

  1. 01Integrate

    Wire the runtime into your app

    Register the runtime, connect your database, and start a first process. The integration guide covers every step with working C#.

  2. 02Explore

    Model a scheme in the designer

    Embed Workflow Designer, build an approval flow, and browse the documentation for schemes, commands, timers, and plugins.

  3. 03Evaluate

    Request a trial key

    Workflow Engine Free has usage limits. A trial key grants temporary access to the licensed product and edition you are evaluating.