EugeneTes b2c2811933 Move NATS connection details from env vars onto the activity nodes
Url/User/Password are now inputs on NatsPublish and NatsTrigger so authors
configure them in the workflow designer. The stored trigger stimulus carries
the connection info too, so messages from server A only fire workflows
designed to listen on server A. Dropped the AddNats singleton wiring and the
Nats section from appsettings.

A NatsConnectionCache singleton hands out one NatsConnection per unique
(url, user, password) so repeat publishes and each hosted-service consumer
loop reuse the same TCP session.
2026-09-02 09:57:04 +00:00

Elsa Custom Server

Custom Elsa Workflows API server. Extends stock Elsa 3.x with our own activities.

Where activities live

src/Elsa.CustomServer/Activities/*.cs — anything marked [Activity(...)] under this folder is auto-registered via AddActivitiesFrom<Program>() in Program.cs.

To add a new node type in the Studio designer:

  1. Drop a new file under Activities/.
  2. Inherit from CodeActivity, CodeActivity<T>, or Activity for triggerable ones.
  3. Rebuild and redeploy — Studio picks it up automatically the next time it fetches the activity descriptors.

Example — see Activities/Shout.cs.

Local run

dotnet run --project src/Elsa.CustomServer

Listens on http://localhost:8080; API root is /elsa/api.

Docker

docker build -t elsa-custom-server .
docker run --rm -p 8080:8080 \
  -e Identity__Tokens__SigningKey="$(openssl rand -base64 64)" \
  elsa-custom-server

Deployment

Coolify builds this image from the Dockerfile at repo root when the app is created with build_pack: "dockerfile". The Studio (separate container running the stock elsaworkflows/elsa-studio-v3 image) needs its BACKEND__URL env var pointed at this server's /elsa/api.

Description
No description provided
Readme 97 KiB
Languages
C# 85.7%
HTML 10.7%
Dockerfile 3.6%