{
  "manifest_version": "1.0.0",
  "template": {
    "id": "fe51e94d-e7bd-4363-894d-48b0370c45f8",
    "slug": "kafka",
    "name": "Apache Kafka — Open Source RabbitMQ Alternative for High-Throughput Streaming",
    "description": "Self-host Kafka with KRaft mode, pub/sub, log replay, Flink/Spark-ready",
    "url": "https://railway.com/deploy/kafka",
    "upstream": {
      "image": "apache/kafka:latest"
    }
  },
  "services": [
    {
      "name": "Kafka",
      "source": {
        "image": "apache/kafka:latest"
      },
      "needs_volume": true,
      "volume_mount_path": "/var/lib/kafka/data",
      "tcp_ports": [
        9094
      ],
      "http": false
    }
  ],
  "required_inputs": [
    {
      "key": "KAFKA_NODE_ID",
      "service": "Kafka",
      "description": "Unique identifier for broker node",
      "secret": false,
      "strategy": "default",
      "default": "1"
    },
    {
      "key": "KAFKA_LOG_DIRS",
      "service": "Kafka",
      "description": "Directory storing Kafka log data",
      "secret": false,
      "strategy": "default",
      "default": "/var/lib/kafka/data"
    },
    {
      "key": "KAFKA_LISTENERS",
      "service": "Kafka",
      "description": "Kafka listener endpoints configuration",
      "secret": false,
      "strategy": "default",
      "default": "INTERNAL://:9092,EXTERNAL://:9094,CONTROLLER://:9093"
    },
    {
      "key": "RAILWAY_RUN_UID",
      "service": "Kafka",
      "description": "Run container using root user",
      "secret": false,
      "strategy": "default",
      "default": "0"
    },
    {
      "key": "KAFKA_PROCESS_ROLES",
      "service": "Kafka",
      "description": "Node roles in Kafka cluster",
      "secret": false,
      "strategy": "default",
      "default": "broker,controller"
    },
    {
      "key": "KAFKA_ADVERTISED_LISTENERS",
      "service": "Kafka",
      "description": "Broker advertised internal and external listeners",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "KAFKA_CONTROLLER_QUORUM_VOTERS",
      "service": "Kafka",
      "description": "Controller quorum voters configuration",
      "secret": false,
      "strategy": "default",
      "default": "1@localhost:9093"
    },
    {
      "key": "KAFKA_CONTROLLER_LISTENER_NAMES",
      "service": "Kafka",
      "description": "Listener name used by controller",
      "secret": false,
      "strategy": "default",
      "default": "CONTROLLER"
    },
    {
      "key": "KAFKA_INTER_BROKER_LISTENER_NAME",
      "service": "Kafka",
      "description": "Listener used for broker communication",
      "secret": false,
      "strategy": "default",
      "default": "INTERNAL"
    },
    {
      "key": "KAFKA_TRANSACTION_STATE_LOG_MIN_ISR",
      "service": "Kafka",
      "description": "Minimum in-sync replicas transactions",
      "secret": false,
      "strategy": "default",
      "default": "1"
    },
    {
      "key": "KAFKA_LISTENER_SECURITY_PROTOCOL_MAP",
      "service": "Kafka",
      "description": "Map listeners to security protocols",
      "secret": false,
      "strategy": "default",
      "default": "INTERNAL:PLAINTEXT,EXTERNAL:PLAINTEXT,CONTROLLER:PLAINTEXT"
    },
    {
      "key": "KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR",
      "service": "Kafka",
      "description": "Replication factor for offsets topic",
      "secret": false,
      "strategy": "default",
      "default": "1"
    },
    {
      "key": "KAFKA_TRANSACTION_STATE_LOG_REPLICATION_FACTOR",
      "service": "Kafka",
      "description": "Replication factor transaction state logs",
      "secret": false,
      "strategy": "default",
      "default": "1"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "kafka"
      }
    },
    "cli": "railway deploy --template kafka",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "fe51e94d-e7bd-4363-894d-48b0370c45f8",
            "serializedConfig": {
              "buckets": {},
              "services": {
                "d735a245-e924-48de-817b-54ccf4b9c4fc": {
                  "icon": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQqOKEVxLEPXLVAhlOcrfBnIOTzoCU23BwUMA&s",
                  "name": "Kafka",
                  "deploy": {
                    "startCommand": "/bin/sh -c \"rm -rf /var/lib/kafka/data/lost+found && exec /etc/kafka/docker/run\"",
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "apache/kafka:latest"
                  },
                  "variables": {
                    "KAFKA_NODE_ID": {
                      "isOptional": false,
                      "description": "Unique identifier for broker node",
                      "defaultValue": "1"
                    },
                    "KAFKA_LOG_DIRS": {
                      "isOptional": false,
                      "description": "Directory storing Kafka log data",
                      "defaultValue": "/var/lib/kafka/data"
                    },
                    "KAFKA_LISTENERS": {
                      "isOptional": false,
                      "description": "Kafka listener endpoints configuration",
                      "defaultValue": "INTERNAL://:9092,EXTERNAL://:9094,CONTROLLER://:9093"
                    },
                    "RAILWAY_RUN_UID": {
                      "isOptional": false,
                      "description": "Run container using root user",
                      "defaultValue": "0"
                    },
                    "KAFKA_PROCESS_ROLES": {
                      "isOptional": false,
                      "description": "Node roles in Kafka cluster",
                      "defaultValue": "broker,controller"
                    },
                    "KAFKA_ADVERTISED_LISTENERS": {
                      "isOptional": false,
                      "description": "Broker advertised internal and external listeners",
                      "defaultValue": "INTERNAL://${{RAILWAY_PRIVATE_DOMAIN}}:9092,EXTERNAL://${{RAILWAY_TCP_PROXY_DOMAIN}}:${{RAILWAY_TCP_PROXY_PORT}}"
                    },
                    "KAFKA_CONTROLLER_QUORUM_VOTERS": {
                      "isOptional": false,
                      "description": "Controller quorum voters configuration",
                      "defaultValue": "1@localhost:9093"
                    },
                    "KAFKA_CONTROLLER_LISTENER_NAMES": {
                      "isOptional": false,
                      "description": "Listener name used by controller",
                      "defaultValue": "CONTROLLER"
                    },
                    "KAFKA_INTER_BROKER_LISTENER_NAME": {
                      "isOptional": false,
                      "description": "Listener used for broker communication",
                      "defaultValue": "INTERNAL"
                    },
                    "KAFKA_TRANSACTION_STATE_LOG_MIN_ISR": {
                      "isOptional": false,
                      "description": "Minimum in-sync replicas transactions",
                      "defaultValue": "1"
                    },
                    "KAFKA_LISTENER_SECURITY_PROTOCOL_MAP": {
                      "isOptional": false,
                      "description": "Map listeners to security protocols",
                      "defaultValue": "INTERNAL:PLAINTEXT,EXTERNAL:PLAINTEXT,CONTROLLER:PLAINTEXT"
                    },
                    "KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR": {
                      "isOptional": false,
                      "description": "Replication factor for offsets topic",
                      "defaultValue": "1"
                    },
                    "KAFKA_TRANSACTION_STATE_LOG_REPLICATION_FACTOR": {
                      "isOptional": false,
                      "description": "Replication factor transaction state logs",
                      "defaultValue": "1"
                    }
                  },
                  "networking": {
                    "tcpProxies": {
                      "9094": {}
                    }
                  },
                  "volumeMounts": {
                    "d735a245-e924-48de-817b-54ccf4b9c4fc": {
                      "mountPath": "/var/lib/kafka/data"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {},
  "resources": {
    "expected_services": 1,
    "needs_volume": true
  },
  "generated_at": "2026-09-21T22:14:44.200Z",
  "generator_version": "0.1.0",
  "status": "validated",
  "validated_at": "2026-09-20T17:22:19.017Z",
  "success_rate_30d": 1,
  "validation": {
    "last_run_id": "run_04f4aa91fa154e95a499",
    "checks": [
      {
        "name": "workflow_completed",
        "passed": true
      },
      {
        "name": "all_services_deployed",
        "passed": true
      },
      {
        "name": "stays_up",
        "passed": true
      }
    ],
    "typical_ready_seconds": 38,
    "typical_build_seconds": 0,
    "typical_start_seconds": 5,
    "slowest_service": "Kafka"
  }
}
