{
  "manifest_version": "1.0.0",
  "template": {
    "id": "de8ba789-6f31-4269-856b-8501226d2dc0",
    "slug": "waha-whatsapp-api",
    "name": "WAHA [Updated Oct '26]",
    "description": "WhatsApp HTTP API. No per-message fees. Sessions survive redeploys.",
    "url": "https://railway.com/deploy/waha-whatsapp-api",
    "upstream": {
      "image": "devlikeapro/waha"
    }
  },
  "services": [
    {
      "name": "WAHA",
      "source": {
        "image": "devlikeapro/waha"
      },
      "needs_volume": true,
      "volume_mount_path": "/local",
      "http": true
    }
  ],
  "required_inputs": [
    {
      "key": "PORT",
      "service": "WAHA",
      "description": "Port the WAHA server listens on. Pinned to match the domain's target port — do not remove.",
      "secret": false,
      "strategy": "default",
      "default": "3000"
    },
    {
      "key": "WAHA_API_KEY",
      "service": "WAHA",
      "description": "API key required on every /api/* and /health request, as the x-api-key header.",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "WAHA_BASE_URL",
      "service": "WAHA",
      "description": "Internal base URL WAHA uses to build links (e.g. media URLs) within Railway's private network.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "WAHA_PRINT_QR",
      "service": "WAHA",
      "description": "Whether to also print the session login QR code to the logs (use the dashboard instead).",
      "secret": false,
      "strategy": "default",
      "default": "False"
    },
    {
      "key": "WAHA_LOG_LEVEL",
      "service": "WAHA",
      "description": "Log verbosity.",
      "secret": false,
      "strategy": "default",
      "default": "info"
    },
    {
      "key": "WAHA_LOG_FORMAT",
      "service": "WAHA",
      "description": "Log output format.",
      "secret": false,
      "strategy": "default",
      "default": "JSON"
    },
    {
      "key": "WAHA_PUBLIC_URL",
      "service": "WAHA",
      "description": "Public base URL used for externally-reachable links.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "WAHA_MEDIA_STORAGE",
      "service": "WAHA",
      "description": "Where received media is stored (LOCAL, S3, or POSTGRESQL).",
      "secret": false,
      "strategy": "default",
      "default": "LOCAL"
    },
    {
      "key": "WHATSAPP_FILES_FOLDER",
      "service": "WAHA",
      "description": "Scratch folder used for media conversion (voice/video).",
      "secret": false,
      "strategy": "default",
      "default": "/app/.media"
    },
    {
      "key": "WAHA_DASHBOARD_ENABLED",
      "service": "WAHA",
      "description": "Enables the web dashboard at /dashboard for QR-code session login.",
      "secret": false,
      "strategy": "default",
      "default": "True"
    },
    {
      "key": "WHATSAPP_START_SESSION",
      "service": "WAHA",
      "description": "Name of the WhatsApp session auto-started on boot.",
      "secret": false,
      "strategy": "default",
      "default": "default"
    },
    {
      "key": "WAHA_DASHBOARD_PASSWORD",
      "service": "WAHA",
      "description": "Basic-auth password for the dashboard.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "WAHA_DASHBOARD_USERNAME",
      "service": "WAHA",
      "description": "Basic-auth username for the dashboard.",
      "secret": false,
      "strategy": "default",
      "default": "admin"
    },
    {
      "key": "WHATSAPP_DEFAULT_ENGINE",
      "service": "WAHA",
      "description": "WhatsApp engine to use. WEBJS (headless Chromium) is the default; switch to NOWEB for a lighter, browser-free engine on memory-constrained plans.",
      "secret": false,
      "strategy": "default",
      "default": "WEBJS"
    },
    {
      "key": "WHATSAPP_FILES_LIFETIME",
      "service": "WAHA",
      "description": "Seconds before converted media files are deleted; 0 disables auto-deletion.",
      "secret": false,
      "strategy": "default",
      "default": "0"
    },
    {
      "key": "WHATSAPP_SWAGGER_ENABLED",
      "service": "WAHA",
      "description": "Enables Swagger UI at /.",
      "secret": false,
      "strategy": "default",
      "default": "True"
    },
    {
      "key": "WAHA_LOCAL_STORE_BASE_DIR",
      "service": "WAHA",
      "description": "Path on the volume where WhatsApp session data is persisted. Must stay under /local.",
      "secret": false,
      "strategy": "default",
      "default": "/local/.sessions"
    },
    {
      "key": "WHATSAPP_SWAGGER_PASSWORD",
      "service": "WAHA",
      "description": "Basic-auth password for Swagger UI.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "WHATSAPP_SWAGGER_USERNAME",
      "service": "WAHA",
      "description": "Basic-auth username for Swagger UI.",
      "secret": false,
      "strategy": "default",
      "default": "admin"
    },
    {
      "key": "WHATSAPP_RESTART_ALL_SESSIONS",
      "service": "WAHA",
      "description": "This is the fixed variable name (the reference template uses the dead WAHA_RESTART_ALL_SESSIONS, which the app never reads). Automatically restarts stopped WhatsApp sessions after every redeploy.",
      "secret": false,
      "strategy": "default",
      "default": "True"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "waha-whatsapp-api"
      }
    },
    "cli": "railway deploy --template waha-whatsapp-api",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "de8ba789-6f31-4269-856b-8501226d2dc0",
            "serializedConfig": {
              "buckets": {},
              "services": {
                "d57270f4-ff51-4ca4-b62f-d455eb817a8e": {
                  "icon": "https://raw.githubusercontent.com/devlikeapro/waha/refs/heads/core/logo.png",
                  "name": "WAHA",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": "/ping",
                    "restartPolicyType": "ALWAYS",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "devlikeapro/waha"
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "Port the WAHA server listens on. Pinned to match the domain's target port — do not remove.",
                      "defaultValue": "3000"
                    },
                    "WAHA_API_KEY": {
                      "isOptional": false,
                      "description": "API key required on every /api/* and /health request, as the x-api-key header.",
                      "defaultValue": "{{WAHA_API_KEY}}"
                    },
                    "WAHA_BASE_URL": {
                      "isOptional": false,
                      "description": "Internal base URL WAHA uses to build links (e.g. media URLs) within Railway's private network.",
                      "defaultValue": "http://${{RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "WAHA_PRINT_QR": {
                      "isOptional": false,
                      "description": "Whether to also print the session login QR code to the logs (use the dashboard instead).",
                      "defaultValue": "False"
                    },
                    "WAHA_LOG_LEVEL": {
                      "isOptional": false,
                      "description": "Log verbosity.",
                      "defaultValue": "info"
                    },
                    "WAHA_LOG_FORMAT": {
                      "isOptional": false,
                      "description": "Log output format.",
                      "defaultValue": "JSON"
                    },
                    "WAHA_PUBLIC_URL": {
                      "isOptional": false,
                      "description": "Public base URL used for externally-reachable links.",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "WAHA_MEDIA_STORAGE": {
                      "isOptional": false,
                      "description": "Where received media is stored (LOCAL, S3, or POSTGRESQL).",
                      "defaultValue": "LOCAL"
                    },
                    "WHATSAPP_FILES_FOLDER": {
                      "isOptional": false,
                      "description": "Scratch folder used for media conversion (voice/video).",
                      "defaultValue": "/app/.media"
                    },
                    "WAHA_DASHBOARD_ENABLED": {
                      "isOptional": false,
                      "description": "Enables the web dashboard at /dashboard for QR-code session login.",
                      "defaultValue": "True"
                    },
                    "WHATSAPP_START_SESSION": {
                      "isOptional": false,
                      "description": "Name of the WhatsApp session auto-started on boot.",
                      "defaultValue": "default"
                    },
                    "WAHA_DASHBOARD_PASSWORD": {
                      "isOptional": false,
                      "description": "Basic-auth password for the dashboard.",
                      "defaultValue": "{{WAHA_DASHBOARD_PASSWORD}}"
                    },
                    "WAHA_DASHBOARD_USERNAME": {
                      "isOptional": false,
                      "description": "Basic-auth username for the dashboard.",
                      "defaultValue": "admin"
                    },
                    "WHATSAPP_DEFAULT_ENGINE": {
                      "isOptional": false,
                      "description": "WhatsApp engine to use. WEBJS (headless Chromium) is the default; switch to NOWEB for a lighter, browser-free engine on memory-constrained plans.",
                      "defaultValue": "WEBJS"
                    },
                    "WHATSAPP_FILES_LIFETIME": {
                      "isOptional": false,
                      "description": "Seconds before converted media files are deleted; 0 disables auto-deletion.",
                      "defaultValue": "0"
                    },
                    "WHATSAPP_SWAGGER_ENABLED": {
                      "isOptional": false,
                      "description": "Enables Swagger UI at /.",
                      "defaultValue": "True"
                    },
                    "WAHA_LOCAL_STORE_BASE_DIR": {
                      "isOptional": false,
                      "description": "Path on the volume where WhatsApp session data is persisted. Must stay under /local.",
                      "defaultValue": "/local/.sessions"
                    },
                    "WHATSAPP_SWAGGER_PASSWORD": {
                      "isOptional": false,
                      "description": "Basic-auth password for Swagger UI.",
                      "defaultValue": "{{WHATSAPP_SWAGGER_PASSWORD}}"
                    },
                    "WHATSAPP_SWAGGER_USERNAME": {
                      "isOptional": false,
                      "description": "Basic-auth username for Swagger UI.",
                      "defaultValue": "admin"
                    },
                    "WHATSAPP_RESTART_ALL_SESSIONS": {
                      "isOptional": false,
                      "description": "This is the fixed variable name (the reference template uses the dead WAHA_RESTART_ALL_SESSIONS, which the app never reads). Automatically restarts stopped WhatsApp sessions after every redeploy.",
                      "defaultValue": "True"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>:3000": {
                        "port": 3000
                      }
                    }
                  },
                  "volumeMounts": {
                    "d57270f4-ff51-4ca4-b62f-d455eb817a8e": {
                      "mountPath": "/local"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {
    "healthcheck": {
      "service": "WAHA",
      "method": "GET",
      "path": "/ping",
      "expect_status": 200
    }
  },
  "resources": {
    "expected_services": 1,
    "needs_volume": true
  },
  "generated_at": "2026-10-10T10:14:37.282Z",
  "generator_version": "0.1.0",
  "status": "validated",
  "validated_at": "2026-10-10T08:05:32.194Z",
  "success_rate_30d": 1,
  "validation": {
    "last_run_id": "run_f03a272067b141839385",
    "checks": [
      {
        "name": "workflow_completed",
        "passed": true
      },
      {
        "name": "all_services_deployed",
        "passed": true
      },
      {
        "name": "healthcheck",
        "passed": true
      },
      {
        "name": "stays_up",
        "passed": true
      }
    ],
    "typical_ready_seconds": 37,
    "typical_build_seconds": 0,
    "typical_start_seconds": 20,
    "slowest_service": "WAHA"
  }
}