Hybrid Deployment

Deploy FlowGenX runtime in your own environment while maintaining cloud management

FlowGenX Hybrid Deployment enables you to run the workflow execution runtime in your own infrastructure—on-premises, in your private cloud, or in a dedicated cloud environment—while leveraging FlowGenX's cloud-based management and design capabilities.

Your Infrastructure, Our Intelligence

Keep your data and processing within your security perimeter while benefiting from FlowGenX's powerful design and management tools.

Data Sovereignty

Low Latency

Network Isolation

Compliance Ready

Deployment Models

Cloud-Hosted (Default)

All components run in FlowGenX's managed cloud infrastructure.

┌─────────────────────────────────────────────────────────┐
│                  FlowGenX Cloud                          │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐     │
│  │  Designer   │  │   Runtime   │  │  Management │     │
│  │   Studio    │  │   Fabric    │  │   Console   │     │
│  └─────────────┘  └─────────────┘  └─────────────┘     │
└─────────────────────────────────────────────────────────┘
                          │
                          ▼
               ┌─────────────────────┐
               │  Your Applications  │
               └─────────────────────┘

Best For:

Quick start and evaluation
Teams without infrastructure management overhead
Standard compliance requirements

Hybrid Deployment

Design in the cloud, execute in your environment.

┌─────────────────────────────────────────────────────────┐
│                  FlowGenX Cloud                          │
│  ┌─────────────┐                 ┌─────────────┐        │
│  │  Designer   │                 │  Management │        │
│  │   Studio    │                 │   Console   │        │
│  └─────────────┘                 └─────────────┘        │
└─────────────────────────┬───────────────────────────────┘
                          │ Control Plane
                          │ (Secure Connection)
┌─────────────────────────┼───────────────────────────────┐
│   Your Environment      │                               │
│  ┌──────────────────────▼────────────────────────────┐ │
│  │              FlowGenX Runtime Agent                │ │
│  │  ┌─────────┐  ┌─────────┐  ┌─────────┐           │ │
│  │  │ Worker  │  │ Worker  │  │ Worker  │           │ │
│  │  │   1     │  │   2     │  │   N     │           │ │
│  │  └─────────┘  └─────────┘  └─────────┘           │ │
│  └───────────────────────────────────────────────────┘ │
│                          │                              │
│  ┌───────────────────────▼───────────────────────────┐ │
│  │              Your Internal Systems                 │ │
│  │    Databases    APIs    File Systems    Queues    │ │
│  └───────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘

Best For:

Data residency requirements
Low-latency access to on-premises systems
Strict network security requirements
Regulated industries (finance, healthcare)

Fully Self-Hosted

Complete FlowGenX deployment in your environment.

┌─────────────────────────────────────────────────────────┐
│                   Your Environment                       │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐     │
│  │  Designer   │  │   Runtime   │  │  Management │     │
│  │   Studio    │  │   Fabric    │  │   Console   │     │
│  └─────────────┘  └─────────────┘  └─────────────┘     │
│                                                          │
│  ┌───────────────────────────────────────────────────┐  │
│  │              Your Internal Systems                 │  │
│  └───────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────┘

Best For:

Air-gapped environments
Maximum security requirements
Complete infrastructure control

Supported Environments

On-Premises

Deploy on your physical servers or virtualized infrastructure.

Requirements:

Linux (Ubuntu 20.04+, RHEL 8+, CentOS 8+)
Docker 20.10+ or Kubernetes 1.24+
4+ CPU cores, 8GB+ RAM per worker
Network access to FlowGenX control plane (hybrid only)

Private Cloud

Deploy on VMware, OpenStack, or other private cloud platforms.

Supported:

VMware vSphere
OpenStack
Proxmox
Nutanix

Public Cloud (Customer Account)

Deploy in your own AWS, Azure, or GCP account.

AWS:

EC2 instances
EKS (Kubernetes)
ECS (Containers)

Azure:

Virtual Machines
AKS (Kubernetes)
Container Instances

Google Cloud:

Compute Engine
GKE (Kubernetes)
Cloud Run

Architecture Components

Runtime Agent

The core execution engine that runs in your environment.

Responsibilities:

Execute workflows and agents
Manage worker processes
Handle local connections
Cache and state management
Metrics collection

Control Plane Connection

Secure communication with FlowGenX cloud (hybrid mode).

Features:

Outbound-only connections (no inbound firewall rules)
TLS 1.3 encryption
Mutual authentication
Automatic reconnection

Data Transmitted:

Workflow definitions
Execution status
Metrics and logs (optional)
Configuration updates

Data NOT Transmitted:

Workflow input/output data
Credentials
Internal system data

Installation

Docker Deployment

# Pull the runtime agent image
docker pull flowgenx/runtime-agent:latest

# Run the agent
docker run -d \
  --name flowgenx-agent \
  -e FLOWGENX_API_KEY=your_api_key \
  -e FLOWGENX_ENVIRONMENT=production \
  -e FLOWGENX_WORKER_COUNT=4 \
  -v /var/flowgenx:/data \
  flowgenx/runtime-agent:latest

Kubernetes Deployment

apiVersion: apps/v1
kind: Deployment
metadata:
  name: flowgenx-runtime
spec:
  replicas: 3
  selector:
    matchLabels:
      app: flowgenx-runtime
  template:
    metadata:
      labels:
        app: flowgenx-runtime
    spec:
      containers:
      - name: runtime-agent
        image: flowgenx/runtime-agent:latest
        env:
        - name: FLOWGENX_API_KEY
          valueFrom:
            secretKeyRef:
              name: flowgenx-secrets
              key: api-key
        resources:
          requests:
            memory: "2Gi"
            cpu: "1"
          limits:
            memory: "4Gi"
            cpu: "2"

Helm Chart

# Add FlowGenX Helm repository
helm repo add flowgenx https://charts.flowgenx.ai

# Install the runtime
helm install flowgenx-runtime flowgenx/runtime-agent \
  --set apiKey=your_api_key \
  --set environment=production \
  --set workers.replicas=3

Configuration

Environment Variables

Variable	Description	Default
`FLOWGENX_API_KEY`	API key for authentication	Required
`FLOWGENX_ENVIRONMENT`	Target environment	`production`
`FLOWGENX_WORKER_COUNT`	Number of worker processes	`4`
`FLOWGENX_LOG_LEVEL`	Logging verbosity	`info`
`FLOWGENX_METRICS_ENABLED`	Send metrics to cloud	`true`
`FLOWGENX_DATA_DIR`	Local data directory	`/var/flowgenx`

Network Requirements

Outbound Connections (Hybrid Mode):

Destination	Port	Protocol	Purpose
`api.flowgenx.ai`	443	HTTPS	Control plane
`telemetry.flowgenx.ai`	443	HTTPS	Metrics (optional)

No inbound connections required.

High Availability

Multi-Node Deployment

Deploy multiple runtime agents for high availability.

                    ┌─────────────┐
                    │ Load        │
                    │ Balancer    │
                    └──────┬──────┘
                           │
         ┌─────────────────┼─────────────────┐
         │                 │                 │
         ▼                 ▼                 ▼
   ┌───────────┐    ┌───────────┐    ┌───────────┐
   │  Agent 1  │    │  Agent 2  │    │  Agent 3  │
   │  (Active) │    │  (Active) │    │  (Active) │
   └───────────┘    └───────────┘    └───────────┘

Cluster Mode

Agents automatically form a cluster for:

Work distribution
Failover handling
Shared state management

Security Considerations

Network Isolation

Deploy in private subnets
Use security groups/firewalls
VPN for hybrid connectivity (optional)

Secrets Management

Credentials stored locally
Integration with HashiCorp Vault
Kubernetes secrets support
AWS Secrets Manager / Azure Key Vault

Audit Logging

Local audit log files
Integration with SIEM systems
Compliance report generation

Monitoring

Built-in Metrics

The runtime agent exposes Prometheus metrics:

flowgenx_workflow_executions_total
flowgenx_workflow_duration_seconds
flowgenx_worker_active_count
flowgenx_connection_errors_total

Grafana Dashboard

Pre-built dashboards available for:

Execution metrics
Worker health
Error rates
Resource utilization

Alerting

Configure alerts for:

Worker failures
High error rates
Resource exhaustion
Connection issues

Migration Guide

From Cloud to Hybrid

Provision infrastructure
Install runtime agent
Configure connections
Test with staging workflows
Migrate production workflows
Update monitoring

From Hybrid to Cloud

Ensure cloud connectivity
Migrate sensitive connections
Update workflow configurations
Decommission local runtime

Support

For hybrid deployment assistance:

Contact Sales for enterprise plans
Documentation for technical guides
Enterprise support for production deployments

Hybrid Deployment

Your Infrastructure, Our Intelligence

Deployment Models

Cloud-Hosted (Default)

Hybrid Deployment

Fully Self-Hosted

Supported Environments

On-Premises

Private Cloud

Public Cloud (Customer Account)

Architecture Components

Runtime Agent

Control Plane Connection

Installation

Docker Deployment

Kubernetes Deployment

Helm Chart

Configuration

Environment Variables

Network Requirements

High Availability

Multi-Node Deployment

Cluster Mode

Security Considerations

Network Isolation

Secrets Management

Audit Logging

Monitoring

Built-in Metrics

Grafana Dashboard

Alerting

Migration Guide

From Cloud to Hybrid

From Hybrid to Cloud

Support

On this page

Ask AI

How can I help you?