Architecture Overview
Nexomatic is built around three roles: Sources, the Hub, and Sinks. Understanding how they interact explains everything else in the platform.
(Webhook, Every day at…, EventGrid,
file watcher, MQTT)"] B["Hub
(Queues and dispatches events)"] C["Sinks
(Windows, Linux, Kubernetes)"] A --> B --> C
Sources
Section titled “Sources”A Source is anything that produces an event. Sources are stateless — they call the Hub to register an event and then their job is done.
Built-in sources include:
| Source | Where it runs | How it triggers |
|---|---|---|
| Webhook | Platform or a source node (unified) | An HTTP POST to a unique URL creates an event |
| Every day at… | Platform or a source node | A cron expression fires an event on a schedule |
| Azure EventGrid | Platform | Messages from an Azure Event Grid topic become events |
| MCP | A source node | AI agents using the Model Context Protocol create events directly |
| File/SMB watcher | Platform or a source node | A file appearing or changing in a watched path creates an event |
| MQTT | Platform or a source node | A message on a subscribed MQTT topic creates an event |
Every event carries a payload — an arbitrary JSON document that is passed to the sink when the task executes.
Sources are executed by nodes — deployed agents that receive events on the platform’s behalf (the source node serves webhooks through its unified webhook engine, schedules through its schedule engine; EventGrid has its own node). A single multi-tenant node runs sources for many tenants at once; a tenant-pinned node serves just one tenant. Either way, the Source row belongs to your tenant and always appears in your Sources list — the node is only the execution layer.
Sources that run on your own infrastructure go through one node service installed on your machine — see the Sources guide for the one-service install story.
Onboarding
Section titled “Onboarding”Platform presets are usable directly — tenants pick them in the flow builder’s “New source…” slide-over; there are no tenant copies.
The Hub
Section titled “The Hub”The Hub sits at the centre of the platform. It:
- Accepts events from Sources and stores them in a queue
- Tracks which Sink agents are connected and what they can handle
- Dispatches queued events to available Sinks over a persistent, outbound-only connection
- Receives task results from Sinks and stores logs and outcome data
- Enforces rate limits and back-pressure when sinks are busy
Sink agents connect outbound from your network to the Hub. No inbound firewall rules are required on your side.
A Sink is an agent process running inside your infrastructure. It maintains a persistent outbound connection to the Hub and waits for tasks to be dispatched.
When a matching event arrives, the Hub sends a Task Request to an available Sink. The Sink:
- Resolves any secrets it needs (fetched securely from the Hub at runtime)
- Executes the configured code module
- Streams the result and logs back to the Hub
The Hub stores the result, updates the event state, and optionally triggers a follow-on event.
Sinks never receive inbound connections. Everything flows outbound from the Sink to the Hub.
Sinks run on nodes — a remote node can serve sinks for many tenants at once, or be pinned to a single tenant. The Sink row stays tenant-owned and visible in that tenant’s Sinks list regardless of which node runs it.
Event Lifecycle
Section titled “Event Lifecycle”Events stay in QUEUED state until a suitable Sink comes online. If no Sink is available, events accumulate safely and drain when connectivity is restored.
| Role | Access |
|---|---|
| Admin | Full read/write access to all resources |
| Viewer | Read-only access to all resources |
Roles are assigned by an Admin in the User Management screen.