{
  "manifest_version": "1.0.0",
  "template": {
    "id": "92a7c732-dabb-4a5e-a14f-2a8bf05c5759",
    "slug": "flowctl",
    "name": "flowctl",
    "description": "Self-service workflow platform with approvals, namespaces, and RBAC",
    "url": "https://railway.com/deploy/flowctl",
    "upstream": {
      "image": "ghcr.io/cvhariharan/flowctl:0.15.0"
    }
  },
  "status": "unvalidated",
  "validated_at": null,
  "success_rate_30d": null,
  "services": [
    {
      "name": "flowctl",
      "source": {
        "image": "ghcr.io/cvhariharan/flowctl:0.15.0"
      },
      "needs_volume": true,
      "volume_mount_path": "/data",
      "http": true
    },
    {
      "name": "postgres",
      "source": {
        "image": "ghcr.io/railwayapp-templates/postgres-ssl:17"
      },
      "needs_volume": true,
      "volume_mount_path": "/var/lib/postgresql/data",
      "http": false
    }
  ],
  "required_inputs": [
    {
      "key": "FLOWCTL_DB__HOST",
      "service": "flowctl",
      "description": "PostgreSQL hostname on Railway private network.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "FLOWCTL_DB__PORT",
      "service": "flowctl",
      "description": "PostgreSQL port.",
      "secret": false,
      "strategy": "default",
      "default": "5432"
    },
    {
      "key": "FLOWCTL_DB__USER",
      "service": "flowctl",
      "description": "PostgreSQL username.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "FLOWCTL_DB__DBNAME",
      "service": "flowctl",
      "description": "PostgreSQL database name.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "FLOWCTL_DB__SSLMODE",
      "service": "flowctl",
      "description": "Postgres SSL mode. disable is fine over Railway private networking.",
      "secret": false,
      "strategy": "default",
      "default": "disable"
    },
    {
      "key": "FLOWCTL_APP__ADDRESS",
      "service": "flowctl",
      "description": "HTTP listen address. Bind IPv4 explicitly for Railway healthchecks.",
      "secret": false,
      "strategy": "default",
      "default": "0.0.0.0:7000"
    },
    {
      "key": "FLOWCTL_APP__USE_TLS",
      "service": "flowctl",
      "description": "TLS termination is handled by Railway. Keep false.",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "FLOWCTL_DB__PASSWORD",
      "service": "flowctl",
      "description": "PostgreSQL password.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "FLOWCTL_APP__ROOT_URL",
      "service": "flowctl",
      "description": "Public URL of Flowctl as seen in the browser. Generate a Railway domain first.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "FLOWCTL_METRICS__PATH",
      "service": "flowctl",
      "description": "Metrics HTTP path.",
      "secret": false,
      "strategy": "default",
      "default": "/metrics"
    },
    {
      "key": "FLOWCTL_LOGGER__BACKEND",
      "service": "flowctl",
      "description": "Execution log storage backend.",
      "secret": false,
      "strategy": "default",
      "default": "file"
    },
    {
      "key": "FLOWCTL_METRICS__ENABLED",
      "service": "flowctl",
      "description": "Expose Prometheus metrics.",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "FLOWCTL_SCHEDULER__WORKERS",
      "service": "flowctl",
      "description": "Number of scheduler workers.",
      "secret": false,
      "strategy": "default",
      "default": "20"
    },
    {
      "key": "FLOWCTL_APP__ADMIN_PASSWORD",
      "service": "flowctl",
      "description": "Initial superadmin password (min 8 chars). Auto-generated; save after deploy.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "FLOWCTL_APP__ADMIN_USERNAME",
      "service": "flowctl",
      "description": "Initial superadmin username. Cannot be changed after first install.",
      "secret": false,
      "strategy": "default",
      "default": "flowctl_admin"
    },
    {
      "key": "FLOWCTL_APP__FLOWS_DIRECTORY",
      "service": "flowctl",
      "description": "Directory for flow definitions (persisted on the volume).",
      "secret": false,
      "strategy": "default",
      "default": "/data/flows"
    },
    {
      "key": "FLOWCTL_KEYSTORE__KEEPER_URL",
      "service": "flowctl",
      "description": "Local encryption key (base64 of 32 bytes). Do not change after first deploy.",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "FLOWCTL_LOGGER__LOG_DIRECTORY",
      "service": "flowctl",
      "description": "Directory for execution logs (persisted on the volume).",
      "secret": false,
      "strategy": "default",
      "default": "/data/logs"
    },
    {
      "key": "FLOWCTL_LOGGER__SCAN_INTERVAL",
      "service": "flowctl",
      "description": "Interval for log retention scans.",
      "secret": false,
      "strategy": "default",
      "default": "1h0m0s"
    },
    {
      "key": "FLOWCTL_MESSENGERS__EMAIL__SSL",
      "service": "flowctl",
      "description": "SMTP TLS mode: none, tls, or starttls.",
      "secret": false,
      "strategy": "default",
      "default": "none"
    },
    {
      "key": "FLOWCTL_MESSENGERS__EMAIL__HOST",
      "service": "flowctl",
      "description": "SMTP host. Required by config validation even when email is disabled.",
      "secret": false,
      "strategy": "default",
      "default": "localhost"
    },
    {
      "key": "FLOWCTL_MESSENGERS__EMAIL__PORT",
      "service": "flowctl",
      "description": "SMTP port. Required by config validation even when email is disabled.",
      "secret": false,
      "strategy": "default",
      "default": "587"
    },
    {
      "key": "FLOWCTL_APP__MAX_FILE_UPLOAD_SIZE",
      "service": "flowctl",
      "description": "Max upload size in bytes (default 100MB).",
      "secret": false,
      "strategy": "default",
      "default": "104857600"
    },
    {
      "key": "FLOWCTL_MESSENGERS__EMAIL__ENABLED",
      "service": "flowctl",
      "description": "Enable SMTP notifications (optional).",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "FLOWCTL_SCHEDULER__DEFAULT_TIMEZONE",
      "service": "flowctl",
      "description": "Default IANA timezone for new schedules.",
      "secret": false,
      "strategy": "default",
      "default": "UTC"
    },
    {
      "key": "FLOWCTL_MESSENGERS__EMAIL__MAX_CONNS",
      "service": "flowctl",
      "description": "Max SMTP connections. Required by config validation (min 1).",
      "secret": false,
      "strategy": "default",
      "default": "10"
    },
    {
      "key": "FLOWCTL_SCHEDULER__CRON_SYNC_INTERVAL",
      "service": "flowctl",
      "description": "How often schedule changes are synced from the database.",
      "secret": false,
      "strategy": "default",
      "default": "5m0s"
    },
    {
      "key": "FLOWCTL_MESSENGERS__EMAIL__FROM_ADDRESS",
      "service": "flowctl",
      "description": "From address. Required by config validation even when email is disabled.",
      "secret": false,
      "strategy": "default",
      "default": "flowctl@example.com"
    },
    {
      "key": "FLOWCTL_SCHEDULER__FLOW_EXECUTION_TIMEOUT",
      "service": "flowctl",
      "description": "Max duration for a single flow execution.",
      "secret": false,
      "strategy": "default",
      "default": "1h"
    },
    {
      "key": "PGDATA",
      "service": "postgres",
      "description": "Filesystem path where PostgreSQL stores its data files.",
      "secret": false,
      "strategy": "default",
      "default": "/var/lib/postgresql/data/pgdata"
    },
    {
      "key": "PGHOST",
      "service": "postgres",
      "description": "PostgreSQL server hostname on the private network.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "PGPORT",
      "service": "postgres",
      "description": "PostgreSQL server port.",
      "secret": false,
      "strategy": "default",
      "default": "5432"
    },
    {
      "key": "PGUSER",
      "service": "postgres",
      "description": "PostgreSQL username used in connection strings.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PGDATABASE",
      "service": "postgres",
      "description": "PostgreSQL database name used in connection strings.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PGPASSWORD",
      "service": "postgres",
      "description": "PostgreSQL password used in connection strings.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "POSTGRES_DB",
      "service": "postgres",
      "description": "Default database name created on initialization.",
      "secret": false,
      "strategy": "default",
      "default": "flowctl"
    },
    {
      "key": "DATABASE_URL",
      "service": "postgres",
      "description": "Internal PostgreSQL connection URL for service-to-service communication.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "POSTGRES_USER",
      "service": "postgres",
      "description": "PostgreSQL username for Flowctl.",
      "secret": false,
      "strategy": "default",
      "default": "flowctl"
    },
    {
      "key": "SSL_CERT_DAYS",
      "service": "postgres",
      "description": "Number of days until the auto-generated SSL certificate expires.",
      "secret": false,
      "strategy": "default",
      "default": "820"
    },
    {
      "key": "POSTGRES_PASSWORD",
      "service": "postgres",
      "description": "Auto-generated PostgreSQL password.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "DATABASE_PUBLIC_URL",
      "service": "postgres",
      "description": "Public PostgreSQL connection URL via TCP proxy for external access.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "RAILWAY_DEPLOYMENT_DRAINING_SECONDS",
      "service": "postgres",
      "description": "Seconds to wait before stopping the previous deployment during a rollout.",
      "secret": false,
      "strategy": "default",
      "default": "60"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "flowctl"
      }
    },
    "cli": "railway deploy --template flowctl",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "92a7c732-dabb-4a5e-a14f-2a8bf05c5759",
            "serializedConfig": {
              "buckets": {},
              "services": {
                "90953878-e1e0-4b99-bdc0-e018a53b11cc": {
                  "icon": "https://flowctl.net/images/full-logo.svg",
                  "name": "flowctl",
                  "deploy": {
                    "startCommand": "/bin/sh -c \"mkdir -p /data/flows /data/logs && /app/flowctl install && exec /app/flowctl start\"",
                    "healthcheckPath": "/ping",
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "ghcr.io/cvhariharan/flowctl:0.15.0"
                  },
                  "variables": {
                    "FLOWCTL_DB__HOST": {
                      "isOptional": false,
                      "description": "PostgreSQL hostname on Railway private network.",
                      "defaultValue": "${{postgres.RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "FLOWCTL_DB__PORT": {
                      "isOptional": false,
                      "description": "PostgreSQL port.",
                      "defaultValue": "5432"
                    },
                    "FLOWCTL_DB__USER": {
                      "isOptional": false,
                      "description": "PostgreSQL username.",
                      "defaultValue": "${{postgres.POSTGRES_USER}}"
                    },
                    "FLOWCTL_DB__DBNAME": {
                      "isOptional": false,
                      "description": "PostgreSQL database name.",
                      "defaultValue": "${{postgres.POSTGRES_DB}}"
                    },
                    "FLOWCTL_DB__SSLMODE": {
                      "isOptional": false,
                      "description": "Postgres SSL mode. disable is fine over Railway private networking.",
                      "defaultValue": "disable"
                    },
                    "FLOWCTL_APP__ADDRESS": {
                      "isOptional": false,
                      "description": "HTTP listen address. Bind IPv4 explicitly for Railway healthchecks.",
                      "defaultValue": "0.0.0.0:7000"
                    },
                    "FLOWCTL_APP__USE_TLS": {
                      "isOptional": false,
                      "description": "TLS termination is handled by Railway. Keep false.",
                      "defaultValue": "false"
                    },
                    "FLOWCTL_DB__PASSWORD": {
                      "isOptional": false,
                      "description": "PostgreSQL password.",
                      "defaultValue": "${{postgres.POSTGRES_PASSWORD}}"
                    },
                    "FLOWCTL_APP__ROOT_URL": {
                      "isOptional": false,
                      "description": "Public URL of Flowctl as seen in the browser. Generate a Railway domain first.",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "FLOWCTL_METRICS__PATH": {
                      "isOptional": false,
                      "description": "Metrics HTTP path.",
                      "defaultValue": "/metrics"
                    },
                    "FLOWCTL_LOGGER__BACKEND": {
                      "isOptional": false,
                      "description": "Execution log storage backend.",
                      "defaultValue": "file"
                    },
                    "FLOWCTL_METRICS__ENABLED": {
                      "isOptional": false,
                      "description": "Expose Prometheus metrics.",
                      "defaultValue": "true"
                    },
                    "FLOWCTL_SCHEDULER__WORKERS": {
                      "isOptional": false,
                      "description": "Number of scheduler workers.",
                      "defaultValue": "20"
                    },
                    "FLOWCTL_APP__ADMIN_PASSWORD": {
                      "isOptional": false,
                      "description": "Initial superadmin password (min 8 chars). Auto-generated; save after deploy.",
                      "defaultValue": "{{FLOWCTL_APP__ADMIN_PASSWORD}}"
                    },
                    "FLOWCTL_APP__ADMIN_USERNAME": {
                      "isOptional": false,
                      "description": "Initial superadmin username. Cannot be changed after first install.",
                      "defaultValue": "flowctl_admin"
                    },
                    "FLOWCTL_APP__FLOWS_DIRECTORY": {
                      "isOptional": false,
                      "description": "Directory for flow definitions (persisted on the volume).",
                      "defaultValue": "/data/flows"
                    },
                    "FLOWCTL_KEYSTORE__KEEPER_URL": {
                      "isOptional": false,
                      "description": "Local encryption key (base64 of 32 bytes). Do not change after first deploy.",
                      "defaultValue": "{{FLOWCTL_KEYSTORE__KEEPER_URL}}"
                    },
                    "FLOWCTL_LOGGER__LOG_DIRECTORY": {
                      "isOptional": false,
                      "description": "Directory for execution logs (persisted on the volume).",
                      "defaultValue": "/data/logs"
                    },
                    "FLOWCTL_LOGGER__SCAN_INTERVAL": {
                      "isOptional": false,
                      "description": "Interval for log retention scans.",
                      "defaultValue": "1h0m0s"
                    },
                    "FLOWCTL_MESSENGERS__EMAIL__SSL": {
                      "isOptional": false,
                      "description": "SMTP TLS mode: none, tls, or starttls.",
                      "defaultValue": "none"
                    },
                    "FLOWCTL_MESSENGERS__EMAIL__HOST": {
                      "isOptional": false,
                      "description": "SMTP host. Required by config validation even when email is disabled.",
                      "defaultValue": "localhost"
                    },
                    "FLOWCTL_MESSENGERS__EMAIL__PORT": {
                      "isOptional": false,
                      "description": "SMTP port. Required by config validation even when email is disabled.",
                      "defaultValue": "587"
                    },
                    "FLOWCTL_APP__MAX_FILE_UPLOAD_SIZE": {
                      "isOptional": false,
                      "description": "Max upload size in bytes (default 100MB).",
                      "defaultValue": "104857600"
                    },
                    "FLOWCTL_MESSENGERS__EMAIL__ENABLED": {
                      "isOptional": false,
                      "description": "Enable SMTP notifications (optional).",
                      "defaultValue": "false"
                    },
                    "FLOWCTL_SCHEDULER__DEFAULT_TIMEZONE": {
                      "isOptional": false,
                      "description": "Default IANA timezone for new schedules.",
                      "defaultValue": "UTC"
                    },
                    "FLOWCTL_MESSENGERS__EMAIL__MAX_CONNS": {
                      "isOptional": false,
                      "description": "Max SMTP connections. Required by config validation (min 1).",
                      "defaultValue": "10"
                    },
                    "FLOWCTL_SCHEDULER__CRON_SYNC_INTERVAL": {
                      "isOptional": false,
                      "description": "How often schedule changes are synced from the database.",
                      "defaultValue": "5m0s"
                    },
                    "FLOWCTL_MESSENGERS__EMAIL__FROM_ADDRESS": {
                      "isOptional": false,
                      "description": "From address. Required by config validation even when email is disabled.",
                      "defaultValue": "flowctl@example.com"
                    },
                    "FLOWCTL_SCHEDULER__FLOW_EXECUTION_TIMEOUT": {
                      "isOptional": false,
                      "description": "Max duration for a single flow execution.",
                      "defaultValue": "1h"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>:7000": {
                        "port": 7000
                      }
                    }
                  },
                  "volumeMounts": {
                    "90953878-e1e0-4b99-bdc0-e018a53b11cc": {
                      "mountPath": "/data"
                    }
                  }
                },
                "c108730b-434a-4d5f-8f87-eece7110864e": {
                  "icon": "https://devicons.railway.com/i/postgresql.svg",
                  "name": "postgres",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "ghcr.io/railwayapp-templates/postgres-ssl:17"
                  },
                  "variables": {
                    "PGDATA": {
                      "isOptional": false,
                      "description": "Filesystem path where PostgreSQL stores its data files.",
                      "defaultValue": "/var/lib/postgresql/data/pgdata"
                    },
                    "PGHOST": {
                      "isOptional": false,
                      "description": "PostgreSQL server hostname on the private network.",
                      "defaultValue": "${{RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "PGPORT": {
                      "isOptional": false,
                      "description": "PostgreSQL server port.",
                      "defaultValue": "5432"
                    },
                    "PGUSER": {
                      "isOptional": false,
                      "description": "PostgreSQL username used in connection strings.",
                      "defaultValue": "${{POSTGRES_USER}}"
                    },
                    "PGDATABASE": {
                      "isOptional": false,
                      "description": "PostgreSQL database name used in connection strings.",
                      "defaultValue": "${{POSTGRES_DB}}"
                    },
                    "PGPASSWORD": {
                      "isOptional": false,
                      "description": "PostgreSQL password used in connection strings.",
                      "defaultValue": "${{POSTGRES_PASSWORD}}"
                    },
                    "POSTGRES_DB": {
                      "isOptional": false,
                      "description": "Default database name created on initialization.",
                      "defaultValue": "flowctl"
                    },
                    "DATABASE_URL": {
                      "isOptional": false,
                      "description": "Internal PostgreSQL connection URL for service-to-service communication.",
                      "defaultValue": "postgresql://${{PGUSER}}:${{POSTGRES_PASSWORD}}@${{RAILWAY_PRIVATE_DOMAIN}}:5432/${{PGDATABASE}}"
                    },
                    "POSTGRES_USER": {
                      "isOptional": false,
                      "description": "PostgreSQL username for Flowctl.",
                      "defaultValue": "flowctl"
                    },
                    "SSL_CERT_DAYS": {
                      "description": "Number of days until the auto-generated SSL certificate expires.",
                      "defaultValue": "820"
                    },
                    "POSTGRES_PASSWORD": {
                      "isOptional": false,
                      "description": "Auto-generated PostgreSQL password.",
                      "defaultValue": "{{POSTGRES_PASSWORD}}"
                    },
                    "DATABASE_PUBLIC_URL": {
                      "description": "Public PostgreSQL connection URL via TCP proxy for external access.",
                      "defaultValue": "postgresql://${{PGUSER}}:${{POSTGRES_PASSWORD}}@${{RAILWAY_TCP_PROXY_DOMAIN}}:${{RAILWAY_TCP_PROXY_PORT}}/${{PGDATABASE}}"
                    },
                    "RAILWAY_DEPLOYMENT_DRAINING_SECONDS": {
                      "description": "Seconds to wait before stopping the previous deployment during a rollout.",
                      "defaultValue": "60"
                    }
                  },
                  "volumeMounts": {
                    "c108730b-434a-4d5f-8f87-eece7110864e": {
                      "mountPath": "/var/lib/postgresql/data"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {
    "healthcheck": {
      "service": "flowctl",
      "method": "GET",
      "path": "/ping",
      "expect_status": 200
    }
  },
  "resources": {
    "expected_services": 2,
    "needs_volume": true
  },
  "generated_at": "2026-09-11T22:14:37.124Z",
  "generator_version": "0.1.0"
}