{
  "manifest_version": "1.0.0",
  "template": {
    "id": "35f2bbca-dff6-4564-86ca-5a8ab1f21f66",
    "slug": "postgres-with-pgbouncer",
    "name": "Postgres with PgBouncer",
    "description": "Add PgBouncer as a connection pooler in front of Postgres",
    "url": "https://railway.com/deploy/postgres-with-pgbouncer"
  },
  "services": [
    {
      "name": "Postgres",
      "source": {
        "image": "ghcr.io/railwayapp-templates/postgres-ssl:18"
      },
      "needs_volume": true,
      "volume_mount_path": "/var/lib/postgresql/data",
      "http": false
    },
    {
      "name": "PgBouncer",
      "source": {
        "image": "ghcr.io/railwayapp-templates/pgbouncer:1"
      },
      "needs_volume": false,
      "http": false
    }
  ],
  "required_inputs": [
    {
      "key": "PGDATA",
      "service": "Postgres",
      "description": "Location where the database will be initialized",
      "secret": false,
      "strategy": "default",
      "default": "/var/lib/postgresql/data/pgdata"
    },
    {
      "key": "PGHOST",
      "service": "Postgres",
      "description": "Railway Private Domain Name.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "PGPORT",
      "service": "Postgres",
      "description": "Port to connect to Postgres.",
      "secret": false,
      "strategy": "default",
      "default": "5432"
    },
    {
      "key": "PGUSER",
      "service": "Postgres",
      "description": "Required variable for Data panel",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PGDATABASE",
      "service": "Postgres",
      "description": "Required variable for the data panel.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PGPASSWORD",
      "service": "Postgres",
      "description": "Required variable for Data panel",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "POSTGRES_DB",
      "service": "Postgres",
      "description": "Default database created when image is started.",
      "secret": false,
      "strategy": "default",
      "default": "railway"
    },
    {
      "key": "DATABASE_URL",
      "service": "Postgres",
      "description": "URL to connect to Postgres database.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "POSTGRES_USER",
      "service": "Postgres",
      "description": "User to connect to Postgres DB",
      "secret": false,
      "strategy": "default",
      "default": "postgres"
    },
    {
      "key": "SSL_CERT_DAYS",
      "service": "Postgres",
      "description": "SSL certificate expiry in days.",
      "secret": false,
      "strategy": "default",
      "default": "820"
    },
    {
      "key": "POSTGRES_PASSWORD",
      "service": "Postgres",
      "description": "Password to connect to DB",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "RAILWAY_DEPLOYMENT_DRAINING_SECONDS",
      "service": "Postgres",
      "description": "Allow Postgres to cleanly shut down",
      "secret": false,
      "strategy": "default",
      "default": "60"
    },
    {
      "key": "PGHOST",
      "service": "PgBouncer",
      "description": "Provide a value for PGHOST.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "PGPORT",
      "service": "PgBouncer",
      "description": "Provide a value for PGPORT.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PGUSER",
      "service": "PgBouncer",
      "description": "Provide a value for PGUSER.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "AUTH_USER",
      "service": "PgBouncer",
      "description": "Provide a value for AUTH_USER.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "POOL_MODE",
      "service": "PgBouncer",
      "description": "Provide a value for POOL_MODE.",
      "secret": false,
      "strategy": "default",
      "default": "transaction"
    },
    {
      "key": "AUTH_QUERY",
      "service": "PgBouncer",
      "description": "Provide a value for AUTH_QUERY.",
      "secret": false,
      "strategy": "default",
      "default": "SELECT usename, passwd FROM pg_shadow WHERE usename=$1"
    },
    {
      "key": "PGPASSWORD",
      "service": "PgBouncer",
      "description": "Provide a value for PGPASSWORD.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "ADMIN_USERS",
      "service": "PgBouncer",
      "description": "Provide a value for ADMIN_USERS.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "POSTGRES_DB",
      "service": "PgBouncer",
      "description": "Provide a value for POSTGRES_DB.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "DATABASE_URL",
      "service": "PgBouncer",
      "description": "Provide a value for DATABASE_URL.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "POSTGRES_USER",
      "service": "PgBouncer",
      "description": "Provide a value for POSTGRES_USER.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "MAX_CLIENT_CONN",
      "service": "PgBouncer",
      "description": "Provide a value for MAX_CLIENT_CONN.",
      "secret": false,
      "strategy": "default",
      "default": "1000"
    },
    {
      "key": "DEFAULT_POOL_SIZE",
      "service": "PgBouncer",
      "description": "Provide a value for DEFAULT_POOL_SIZE.",
      "secret": false,
      "strategy": "default",
      "default": "70"
    },
    {
      "key": "POSTGRES_PASSWORD",
      "service": "PgBouncer",
      "description": "Provide a value for POSTGRES_PASSWORD.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "SERVER_RESET_QUERY",
      "service": "PgBouncer",
      "description": "Provide a value for SERVER_RESET_QUERY.",
      "secret": false,
      "strategy": "default",
      "default": "DISCARD ALL"
    },
    {
      "key": "DATABASE_UNPOOLED_URL",
      "service": "PgBouncer",
      "description": "Provide a value for DATABASE_UNPOOLED_URL.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "MAX_PREPARED_STATEMENTS",
      "service": "PgBouncer",
      "description": "Provide a value for MAX_PREPARED_STATEMENTS.",
      "secret": false,
      "strategy": "default",
      "default": "300"
    },
    {
      "key": "UPSTREAM_POSTGRESQL_HOST",
      "service": "PgBouncer",
      "description": "Provide a value for UPSTREAM_POSTGRESQL_HOST.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "postgres-with-pgbouncer"
      }
    },
    "cli": "railway deploy --template postgres-with-pgbouncer",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "35f2bbca-dff6-4564-86ca-5a8ab1f21f66",
            "serializedConfig": {
              "services": {
                "postgres": {
                  "icon": "https://devicons.railway.app/i/postgresql.svg",
                  "name": "Postgres",
                  "build": {},
                  "deploy": {
                    "requiredMountPath": "/var/lib/postgresql/data"
                  },
                  "source": {
                    "image": "ghcr.io/railwayapp-templates/postgres-ssl:18",
                    "preserveExisting": true
                  },
                  "variables": {
                    "PGDATA": {
                      "isOptional": false,
                      "description": "Location where the database will be initialized",
                      "defaultValue": "/var/lib/postgresql/data/pgdata",
                      "preserveExisting": true
                    },
                    "PGHOST": {
                      "isOptional": false,
                      "description": "Railway Private Domain Name.",
                      "defaultValue": "${{RAILWAY_PRIVATE_DOMAIN}}",
                      "preserveExisting": true
                    },
                    "PGPORT": {
                      "isOptional": false,
                      "description": "Port to connect to Postgres.",
                      "defaultValue": "5432",
                      "preserveExisting": true
                    },
                    "PGUSER": {
                      "isOptional": false,
                      "description": "Required variable for Data panel",
                      "defaultValue": "${{ POSTGRES_USER }}",
                      "preserveExisting": true
                    },
                    "PGDATABASE": {
                      "isOptional": false,
                      "description": "Required variable for the data panel.",
                      "defaultValue": "${{POSTGRES_DB}}",
                      "preserveExisting": true
                    },
                    "PGPASSWORD": {
                      "isOptional": false,
                      "description": "Required variable for Data panel",
                      "defaultValue": "${{POSTGRES_PASSWORD}}",
                      "preserveExisting": true
                    },
                    "POSTGRES_DB": {
                      "isOptional": false,
                      "description": "Default database created when image is started.",
                      "defaultValue": "railway",
                      "preserveExisting": true
                    },
                    "DATABASE_URL": {
                      "isOptional": false,
                      "description": "URL to connect to Postgres database.",
                      "defaultValue": "postgresql://${{PGUSER}}:${{POSTGRES_PASSWORD}}@${{RAILWAY_PRIVATE_DOMAIN}}:5432/${{PGDATABASE}}",
                      "preserveExisting": true
                    },
                    "POSTGRES_USER": {
                      "isOptional": false,
                      "description": "User to connect to Postgres DB",
                      "defaultValue": "postgres",
                      "preserveExisting": true
                    },
                    "SSL_CERT_DAYS": {
                      "isOptional": true,
                      "description": "SSL certificate expiry in days.",
                      "defaultValue": "820",
                      "preserveExisting": true
                    },
                    "POSTGRES_PASSWORD": {
                      "isOptional": false,
                      "description": "Password to connect to DB",
                      "defaultValue": "{{POSTGRES_PASSWORD}}",
                      "preserveExisting": true
                    },
                    "RAILWAY_DEPLOYMENT_DRAINING_SECONDS": {
                      "isOptional": false,
                      "description": "Allow Postgres to cleanly shut down",
                      "defaultValue": "60",
                      "preserveExisting": true
                    }
                  },
                  "networking": {
                    "serviceDomains": {}
                  },
                  "clusterRole": "root",
                  "volumeMounts": {
                    "f685ce60-490a-4bec-8ac0-3ab3e89b42d2": {
                      "mountPath": "/var/lib/postgresql/data"
                    }
                  }
                },
                "pgbouncer": {
                  "icon": "https://devicons.railway.app/postgres",
                  "name": "PgBouncer",
                  "deploy": {
                    "numReplicas": 3,
                    "restartPolicyType": "ALWAYS"
                  },
                  "source": {
                    "image": "ghcr.io/railwayapp-templates/pgbouncer:1",
                    "autoUpdates": {
                      "type": "minor",
                      "tagMode": "sha",
                      "schedule": [
                        {
                          "day": 6,
                          "endHour": 6,
                          "startHour": 0
                        }
                      ]
                    }
                  },
                  "exposure": {
                    "5432": {
                      "variables": {
                        "DATABASE_PUBLIC_URL": {
                          "value": "postgres://${{Postgres.PGUSER}}:${{Postgres.PGPASSWORD}}@${{RAILWAY_TCP_PROXY_DOMAIN}}:${{RAILWAY_TCP_PROXY_PORT}}/${{Postgres.PGDATABASE}}"
                        },
                        "DATABASE_PUBLIC_UNPOOLED_URL": {
                          "value": "${{Postgres.DATABASE_PUBLIC_URL}}"
                        }
                      }
                    }
                  },
                  "variables": {
                    "PGHOST": {
                      "defaultValue": "${{RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "PGPORT": {
                      "defaultValue": "${{Postgres.PGPORT}}"
                    },
                    "PGUSER": {
                      "defaultValue": "${{Postgres.PGUSER}}"
                    },
                    "AUTH_USER": {
                      "defaultValue": "${{Postgres.PGUSER}}"
                    },
                    "POOL_MODE": {
                      "defaultValue": "transaction"
                    },
                    "AUTH_QUERY": {
                      "defaultValue": "SELECT usename, passwd FROM pg_shadow WHERE usename=$1"
                    },
                    "PGPASSWORD": {
                      "defaultValue": "${{Postgres.PGPASSWORD}}"
                    },
                    "ADMIN_USERS": {
                      "isOptional": false,
                      "defaultValue": "${{AUTH_USER}}"
                    },
                    "POSTGRES_DB": {
                      "defaultValue": "${{Postgres.POSTGRES_DB}}"
                    },
                    "DATABASE_URL": {
                      "defaultValue": "postgresql://${{PGUSER}}:${{PGPASSWORD}}@${{PGHOST}}:5432/${{Postgres.PGDATABASE}}"
                    },
                    "POSTGRES_USER": {
                      "defaultValue": "${{Postgres.POSTGRES_USER}}"
                    },
                    "MAX_CLIENT_CONN": {
                      "defaultValue": "1000"
                    },
                    "DEFAULT_POOL_SIZE": {
                      "defaultValue": "70"
                    },
                    "POSTGRES_PASSWORD": {
                      "defaultValue": "${{Postgres.POSTGRES_PASSWORD}}"
                    },
                    "SERVER_RESET_QUERY": {
                      "defaultValue": "DISCARD ALL"
                    },
                    "DATABASE_UNPOOLED_URL": {
                      "defaultValue": "${{Postgres.DATABASE_URL}}"
                    },
                    "MAX_PREPARED_STATEMENTS": {
                      "defaultValue": "300"
                    },
                    "UPSTREAM_POSTGRESQL_HOST": {
                      "defaultValue": "${{Postgres.RAILWAY_PRIVATE_DOMAIN}}"
                    }
                  },
                  "clusterRole": "edge",
                  "clusterDisplay": {
                    "badge": "PgBouncer",
                    "badgeVariant": "secondary"
                  },
                  "parentServiceId": "Postgres"
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {},
  "resources": {
    "expected_services": 2,
    "needs_volume": true
  },
  "generated_at": "2026-09-10T16:14:52.212Z",
  "generator_version": "0.1.0",
  "status": "validated",
  "validated_at": "2026-09-09T04:39:43.799Z",
  "success_rate_30d": 1,
  "validation": {
    "last_run_id": "run_e9acf2a19b694ad2893b",
    "checks": [
      {
        "name": "workflow_completed",
        "passed": true
      },
      {
        "name": "all_services_deployed",
        "passed": true
      },
      {
        "name": "stays_up",
        "passed": true
      }
    ],
    "typical_ready_seconds": 83,
    "typical_build_seconds": 0,
    "typical_start_seconds": 0,
    "slowest_service": "PgBouncer"
  }
}