{
  "manifest_version": "1.0.0",
  "template": {
    "id": "ce3a660f-2993-4c9c-bca5-1cf9b98e66cf",
    "slug": "convex-backend",
    "name": "Convex Backend",
    "description": "Reactive database and backend for building realtime apps",
    "url": "https://railway.com/deploy/convex-backend",
    "upstream": {
      "image": "ghcr.io/get-convex/convex-dashboard:c0cb7ae17f54e14846c243c5332a8a5e6d0e19d4"
    }
  },
  "services": [
    {
      "name": "convex-postgres",
      "source": {
        "image": "postgres:17"
      },
      "needs_volume": true,
      "volume_mount_path": "/var/lib/postgresql/data",
      "http": false
    },
    {
      "name": "convex-dashboard",
      "source": {
        "image": "ghcr.io/get-convex/convex-dashboard:c0cb7ae17f54e14846c243c5332a8a5e6d0e19d4"
      },
      "needs_volume": false,
      "http": true
    },
    {
      "name": "convex-backend",
      "source": {
        "image": "ghcr.io/get-convex/convex-backend:c0cb7ae17f54e14846c243c5332a8a5e6d0e19d4"
      },
      "needs_volume": true,
      "volume_mount_path": "/convex/data",
      "http": true
    }
  ],
  "required_inputs": [
    {
      "key": "PGDATA",
      "service": "convex-postgres",
      "description": "Cluster location on the volume",
      "secret": false,
      "strategy": "default",
      "default": "/var/lib/postgresql/data/pgdata"
    },
    {
      "key": "POSTGRES_DB",
      "service": "convex-postgres",
      "description": "Database created on first boot",
      "secret": false,
      "strategy": "default",
      "default": "convex_self_hosted"
    },
    {
      "key": "POSTGRES_USER",
      "service": "convex-postgres",
      "description": "Superuser created on first boot",
      "secret": false,
      "strategy": "default",
      "default": "convex"
    },
    {
      "key": "POSTGRES_PASSWORD",
      "service": "convex-postgres",
      "description": "Superuser password",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "RAILWAY_DEPLOYMENT_DRAINING_SECONDS",
      "service": "convex-postgres",
      "description": "Clean shutdown window",
      "secret": false,
      "strategy": "default",
      "default": "60"
    },
    {
      "key": "PORT",
      "service": "convex-dashboard",
      "description": "HTTP server listening port",
      "secret": false,
      "strategy": "default",
      "default": "6791"
    },
    {
      "key": "NEXT_PUBLIC_DEPLOYMENT_URL",
      "service": "convex-dashboard",
      "description": "Backend URL prefilled at login",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "PORT",
      "service": "convex-backend",
      "description": "Port Railway health checks probe",
      "secret": false,
      "strategy": "default",
      "default": "3210"
    },
    {
      "key": "RUST_LOG",
      "service": "convex-backend",
      "description": "Backend log verbosity",
      "secret": false,
      "strategy": "default",
      "default": "info"
    },
    {
      "key": "POSTGRES_URL",
      "service": "convex-backend",
      "description": "No database name, no query string",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "INSTANCE_NAME",
      "service": "convex-backend",
      "description": "Deployment name; sets database name",
      "secret": false,
      "strategy": "default",
      "default": "convex-self-hosted"
    },
    {
      "key": "DISABLE_BEACON",
      "service": "convex-backend",
      "description": "Disable anonymous usage telemetry",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "INSTANCE_SECRET",
      "service": "convex-backend",
      "description": "Hex key that signs admin keys",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "CONVEX_SITE_ORIGIN",
      "service": "convex-backend",
      "description": "Public origin for HTTP actions",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "DO_NOT_REQUIRE_SSL",
      "service": "convex-backend",
      "description": "Permit private non-TLS database link",
      "secret": false,
      "strategy": "default",
      "default": "1"
    },
    {
      "key": "CONVEX_CLOUD_ORIGIN",
      "service": "convex-backend",
      "description": "Public API origin for clients",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "RAILWAY_DEPLOYMENT_DRAINING_SECONDS",
      "service": "convex-backend",
      "description": "Clean shutdown window",
      "secret": false,
      "strategy": "default",
      "default": "30"
    },
    {
      "key": "APPLICATION_MAX_CONCURRENT_V8_ACTIONS",
      "service": "convex-backend",
      "description": "Concurrent V8 action limit",
      "secret": false,
      "strategy": "default",
      "default": "16"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "convex-backend"
      }
    },
    "cli": "railway deploy --template convex-backend",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "ce3a660f-2993-4c9c-bca5-1cf9b98e66cf",
            "serializedConfig": {
              "buckets": {},
              "services": {
                "4a9360dc-cee7-43c1-ba52-41de297abaf0": {
                  "icon": "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/postgresql.svg",
                  "name": "convex-postgres",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "postgres:17"
                  },
                  "variables": {
                    "PGDATA": {
                      "isOptional": false,
                      "description": "Cluster location on the volume",
                      "defaultValue": "/var/lib/postgresql/data/pgdata"
                    },
                    "POSTGRES_DB": {
                      "isOptional": false,
                      "description": "Database created on first boot",
                      "defaultValue": "convex_self_hosted"
                    },
                    "POSTGRES_USER": {
                      "isOptional": false,
                      "description": "Superuser created on first boot",
                      "defaultValue": "convex"
                    },
                    "POSTGRES_PASSWORD": {
                      "isOptional": false,
                      "description": "Superuser password",
                      "defaultValue": "{{POSTGRES_PASSWORD}}"
                    },
                    "RAILWAY_DEPLOYMENT_DRAINING_SECONDS": {
                      "isOptional": false,
                      "description": "Clean shutdown window",
                      "defaultValue": "60"
                    }
                  },
                  "volumeMounts": {
                    "4a9360dc-cee7-43c1-ba52-41de297abaf0": {
                      "mountPath": "/var/lib/postgresql/data"
                    }
                  }
                },
                "62f19dbb-08e5-45c2-a9f6-6329c84d58a3": {
                  "icon": "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/convex.svg",
                  "name": "convex-dashboard",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "ghcr.io/get-convex/convex-dashboard:c0cb7ae17f54e14846c243c5332a8a5e6d0e19d4"
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "HTTP server listening port",
                      "defaultValue": "6791"
                    },
                    "NEXT_PUBLIC_DEPLOYMENT_URL": {
                      "isOptional": false,
                      "description": "Backend URL prefilled at login",
                      "defaultValue": "https://${{convex-backend.RAILWAY_PUBLIC_DOMAIN}}"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>:6791": {
                        "port": 6791
                      }
                    }
                  }
                },
                "92e6b698-44d6-4078-8abe-23f49f67229f": {
                  "icon": "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/convex.svg",
                  "name": "convex-backend",
                  "deploy": {
                    "startCommand": "/bin/bash -c 'set -e; source ./read_credentials.sh; K=$(./generate_key \"$INSTANCE_NAME\" \"$INSTANCE_SECRET\"); printf \"%s\\n\" \"$K\" > \"$CREDENTIALS_DIR/admin_key\"; echo \"===== CONVEX ADMIN KEY (copy this, it is your dashboard login) =====\"; echo \"$K\"; echo \"===== END CONVEX ADMIN KEY =====\"; exec ./run_backend.sh'",
                    "healthcheckPath": "/version",
                    "restartPolicyType": "ALWAYS",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "ghcr.io/get-convex/convex-backend:c0cb7ae17f54e14846c243c5332a8a5e6d0e19d4"
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "Port Railway health checks probe",
                      "defaultValue": "3210"
                    },
                    "RUST_LOG": {
                      "isOptional": false,
                      "description": "Backend log verbosity",
                      "defaultValue": "info"
                    },
                    "POSTGRES_URL": {
                      "isOptional": false,
                      "description": "No database name, no query string",
                      "defaultValue": "postgresql://${{convex-postgres.POSTGRES_USER}}:${{convex-postgres.POSTGRES_PASSWORD}}@${{convex-postgres.RAILWAY_PRIVATE_DOMAIN}}:5432"
                    },
                    "INSTANCE_NAME": {
                      "isOptional": false,
                      "description": "Deployment name; sets database name",
                      "defaultValue": "convex-self-hosted"
                    },
                    "DISABLE_BEACON": {
                      "isOptional": false,
                      "description": "Disable anonymous usage telemetry",
                      "defaultValue": "true"
                    },
                    "INSTANCE_SECRET": {
                      "isOptional": false,
                      "description": "Hex key that signs admin keys",
                      "defaultValue": "{{INSTANCE_SECRET}}"
                    },
                    "CONVEX_SITE_ORIGIN": {
                      "isOptional": false,
                      "description": "Public origin for HTTP actions",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}/http"
                    },
                    "DO_NOT_REQUIRE_SSL": {
                      "isOptional": false,
                      "description": "Permit private non-TLS database link",
                      "defaultValue": "1"
                    },
                    "CONVEX_CLOUD_ORIGIN": {
                      "isOptional": false,
                      "description": "Public API origin for clients",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "RAILWAY_DEPLOYMENT_DRAINING_SECONDS": {
                      "isOptional": false,
                      "description": "Clean shutdown window",
                      "defaultValue": "30"
                    },
                    "APPLICATION_MAX_CONCURRENT_V8_ACTIONS": {
                      "isOptional": false,
                      "description": "Concurrent V8 action limit",
                      "defaultValue": "16"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>:3210": {
                        "port": 3210
                      }
                    }
                  },
                  "volumeMounts": {
                    "92e6b698-44d6-4078-8abe-23f49f67229f": {
                      "mountPath": "/convex/data"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {
    "healthcheck": {
      "service": "convex-backend",
      "method": "GET",
      "path": "/version",
      "expect_status": 200
    }
  },
  "resources": {
    "expected_services": 3,
    "needs_volume": true
  },
  "generated_at": "2026-09-20T16:14:49.616Z",
  "generator_version": "0.1.0",
  "status": "degraded",
  "validated_at": "2026-09-19T17:01:19.922Z",
  "success_rate_30d": 0,
  "validation": {
    "last_run_id": "run_b064ffd3527641d5b045",
    "checks": [
      {
        "name": "workflow_completed",
        "passed": true
      },
      {
        "name": "all_services_deployed",
        "passed": false,
        "detail": "SUCCESS,DEPLOYING,FAILED"
      }
    ]
  }
}
