{
  "manifest_version": "1.0.0",
  "template": {
    "id": "906b4c39-60a7-42b6-ba32-dfdceacfef85",
    "slug": "skillhub-registry",
    "name": "SkillHub | Self-Hosted Agent Skill Registry (ClawHub Alternative)",
    "description": "Self-hosted registry for AI agent skills: publish, scan, version, RBAC",
    "url": "https://railway.com/deploy/skillhub-registry",
    "upstream": {
      "repo_url": "https://github.com/nomideusz/skillhub-railway"
    }
  },
  "services": [
    {
      "name": "server",
      "source": {
        "image": "ghcr.io/iflytek/skillhub-server:v0.2.22"
      },
      "needs_volume": true,
      "volume_mount_path": "/var/lib/skillhub/storage",
      "http": false
    },
    {
      "name": "Postgres",
      "source": {
        "image": "postgres:16.15-alpine"
      },
      "needs_volume": true,
      "volume_mount_path": "/var/lib/postgresql/data",
      "http": false
    },
    {
      "name": "Redis",
      "source": {
        "image": "redis:8.10.2-alpine"
      },
      "needs_volume": true,
      "volume_mount_path": "/data",
      "http": false
    },
    {
      "name": "SkillHub",
      "source": {
        "repo": "https://github.com/nomideusz/skillhub-railway"
      },
      "needs_volume": false,
      "http": true
    },
    {
      "name": "scanner",
      "source": {
        "image": "ghcr.io/iflytek/skillhub-scanner:v0.2.22"
      },
      "needs_volume": false,
      "http": false
    }
  ],
  "required_inputs": [
    {
      "key": "PORT",
      "service": "server",
      "description": "Server port - leave as is",
      "secret": false,
      "strategy": "default",
      "default": "8080"
    },
    {
      "key": "RAILWAY_RUN_UID",
      "service": "server",
      "description": "The image runs as a non-root user; Railway volumes are root-owned",
      "secret": false,
      "strategy": "default",
      "default": "0"
    },
    {
      "key": "MALLOC_ARENA_MAX",
      "service": "server",
      "description": "Fewer glibc malloc arenas - saves ~100 MB of RAM for the JVM",
      "secret": false,
      "strategy": "default",
      "default": "2"
    },
    {
      "key": "JAVA_TOOL_OPTIONS",
      "service": "server",
      "description": "JVM memory caps. Without them the JVM sizes itself from the plan's RAM limit, not from what the registry needs. Raise -Xmx for many users or big uploads.",
      "secret": false,
      "strategy": "default",
      "default": "-Xmx512m -XX:+UseSerialGC -XX:MaxMetaspaceSize=192m -XX:ReservedCodeCacheSize=64m -Xss512k"
    },
    {
      "key": "STORAGE_BASE_PATH",
      "service": "server",
      "description": "Volume path for skill packages",
      "secret": false,
      "strategy": "default",
      "default": "/var/lib/skillhub/storage"
    },
    {
      "key": "SKILLHUB_LOG_FORMAT",
      "service": "server",
      "description": "Log format",
      "secret": false,
      "strategy": "default",
      "default": "json"
    },
    {
      "key": "BOOTSTRAP_ADMIN_EMAIL",
      "service": "server",
      "description": "Email of the first admin account",
      "secret": false,
      "strategy": "default",
      "default": "admin@skillhub.local"
    },
    {
      "key": "SESSION_COOKIE_SECURE",
      "service": "server",
      "description": "Send the session cookie over https only",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "SPRING_DATASOURCE_URL",
      "service": "server",
      "description": "Postgres connection",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "SPRING_DATA_REDIS_HOST",
      "service": "server",
      "description": "Redis host",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "SPRING_DATA_REDIS_PORT",
      "service": "server",
      "description": "Redis port",
      "secret": false,
      "strategy": "default",
      "default": "6379"
    },
    {
      "key": "BOOTSTRAP_ADMIN_ENABLED",
      "service": "server",
      "description": "Create the admin account on first boot",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "BOOTSTRAP_ADMIN_PASSWORD",
      "service": "server",
      "description": "Password of the first admin account (username: admin). Only used when the account is first created - change it later in the UI.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "BOOTSTRAP_ADMIN_USERNAME",
      "service": "server",
      "description": "Username of the first admin account",
      "secret": false,
      "strategy": "default",
      "default": "admin"
    },
    {
      "key": "SKILLHUB_PUBLIC_BASE_URL",
      "service": "server",
      "description": "Public URL of the registry (the SkillHub web service)",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "SKILLHUB_STORAGE_PROVIDER",
      "service": "server",
      "description": "Skill packages are stored on this service's volume",
      "secret": false,
      "strategy": "default",
      "default": "local"
    },
    {
      "key": "SPRING_DATASOURCE_PASSWORD",
      "service": "server",
      "description": "Postgres password",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "SPRING_DATASOURCE_USERNAME",
      "service": "server",
      "description": "Postgres user",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "SPRING_DATA_REDIS_PASSWORD",
      "service": "server",
      "description": "Redis password",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "SKILLHUB_SERVICE_ENVIRONMENT",
      "service": "server",
      "description": "Environment label",
      "secret": false,
      "strategy": "default",
      "default": "production"
    },
    {
      "key": "SKILLHUB_SECURITY_SCANNER_URL",
      "service": "server",
      "description": "Scanner service on the private network",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "SKILLHUB_SECURITY_SCANNER_MODE",
      "service": "server",
      "description": "Send packages to the scanner over HTTP",
      "secret": false,
      "strategy": "default",
      "default": "upload"
    },
    {
      "key": "SKILLHUB_SECURITY_SCANNER_ENABLED",
      "service": "server",
      "description": "Scan every uploaded skill with the scanner service before it is published",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "SKILLHUB_DOWNLOAD_ANON_COOKIE_SECRET",
      "service": "server",
      "description": "Signs anonymous download rate-limit cookies",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "SKILLHUB_SUITE_REVIEW_WRITES_ENABLED",
      "service": "server",
      "description": "Safe with a single server replica",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "SKILLHUB_AUTH_INITIAL_SELF_REGISTRATION_ENABLED",
      "service": "server",
      "description": "Whether anyone can sign up on first boot. Off so a public URL isn't an open registry; the admin can turn it on in the UI.",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "PGDATA",
      "service": "Postgres",
      "description": "Data subdirectory - keeps Postgres happy on Railway volumes",
      "secret": false,
      "strategy": "default",
      "default": "/var/lib/postgresql/data/pgdata"
    },
    {
      "key": "POSTGRES_DB",
      "service": "Postgres",
      "description": "Database name",
      "secret": false,
      "strategy": "default",
      "default": "skillhub"
    },
    {
      "key": "POSTGRES_USER",
      "service": "Postgres",
      "description": "Database user",
      "secret": false,
      "strategy": "default",
      "default": "skillhub"
    },
    {
      "key": "POSTGRES_PASSWORD",
      "service": "Postgres",
      "description": "Auto-generated database password",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "RAILWAY_DEPLOYMENT_DRAINING_SECONDS",
      "service": "Postgres",
      "description": "Time for Postgres to shut down cleanly on redeploy",
      "secret": false,
      "strategy": "default",
      "default": "60"
    },
    {
      "key": "REDIS_PASSWORD",
      "service": "Redis",
      "description": "Auto-generated Redis password",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "PORT",
      "service": "SkillHub",
      "description": "nginx port behind the Railway domain - leave as is",
      "secret": false,
      "strategy": "default",
      "default": "80"
    },
    {
      "key": "SKILLHUB_ALLOW_SIGNUP",
      "service": "SkillHub",
      "description": "Let anyone with the URL create an account. Off by default: the admin creates accounts, or you set this to true and redeploy.",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "SKILLHUB_API_UPSTREAM",
      "service": "SkillHub",
      "description": "Where nginx forwards /api - the server service on the private network",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "SKILLHUB_PUBLIC_BASE_URL",
      "service": "SkillHub",
      "description": "Public URL of this registry, used in the agent install guide",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "SKILLHUB_TRUST_FORWARDED_PROTO",
      "service": "SkillHub",
      "description": "Trust Railway's edge X-Forwarded-Proto so login cookies and redirects use https",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "PORT",
      "service": "scanner",
      "description": "Scanner port - leave as is",
      "secret": false,
      "strategy": "default",
      "default": "8000"
    },
    {
      "key": "SKILLHUB_SCANNER_MAX_CONCURRENT_SCANS",
      "service": "scanner",
      "description": "Scans running at once",
      "secret": false,
      "strategy": "default",
      "default": "1"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "skillhub-registry"
      }
    },
    "cli": "railway deploy --template skillhub-registry",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "906b4c39-60a7-42b6-ba32-dfdceacfef85",
            "serializedConfig": {
              "buckets": {},
              "services": {
                "0f851003-4e3b-4bdb-8b6f-e002f55af19f": {
                  "icon": "https://raw.githubusercontent.com/nomideusz/skillhub-railway/main/icon.png",
                  "name": "server",
                  "build": {},
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": "/actuator/health",
                    "restartPolicyType": "ON_FAILURE",
                    "healthcheckTimeout": 300,
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "ghcr.io/iflytek/skillhub-server:v0.2.22"
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "Server port - leave as is",
                      "defaultValue": "8080"
                    },
                    "RAILWAY_RUN_UID": {
                      "isOptional": false,
                      "description": "The image runs as a non-root user; Railway volumes are root-owned",
                      "defaultValue": "0"
                    },
                    "MALLOC_ARENA_MAX": {
                      "isOptional": false,
                      "description": "Fewer glibc malloc arenas - saves ~100 MB of RAM for the JVM",
                      "defaultValue": "2"
                    },
                    "JAVA_TOOL_OPTIONS": {
                      "isOptional": false,
                      "description": "JVM memory caps. Without them the JVM sizes itself from the plan's RAM limit, not from what the registry needs. Raise -Xmx for many users or big uploads.",
                      "defaultValue": "-Xmx512m -XX:+UseSerialGC -XX:MaxMetaspaceSize=192m -XX:ReservedCodeCacheSize=64m -Xss512k"
                    },
                    "STORAGE_BASE_PATH": {
                      "isOptional": false,
                      "description": "Volume path for skill packages",
                      "defaultValue": "/var/lib/skillhub/storage"
                    },
                    "SKILLHUB_LOG_FORMAT": {
                      "isOptional": false,
                      "description": "Log format",
                      "defaultValue": "json"
                    },
                    "BOOTSTRAP_ADMIN_EMAIL": {
                      "isOptional": false,
                      "description": "Email of the first admin account",
                      "defaultValue": "admin@skillhub.local"
                    },
                    "SESSION_COOKIE_SECURE": {
                      "isOptional": false,
                      "description": "Send the session cookie over https only",
                      "defaultValue": "true"
                    },
                    "SPRING_DATASOURCE_URL": {
                      "isOptional": false,
                      "description": "Postgres connection",
                      "defaultValue": "jdbc:postgresql://${{Postgres.RAILWAY_PRIVATE_DOMAIN}}:5432/${{Postgres.POSTGRES_DB}}"
                    },
                    "SPRING_DATA_REDIS_HOST": {
                      "isOptional": false,
                      "description": "Redis host",
                      "defaultValue": "${{Redis.RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "SPRING_DATA_REDIS_PORT": {
                      "isOptional": false,
                      "description": "Redis port",
                      "defaultValue": "6379"
                    },
                    "BOOTSTRAP_ADMIN_ENABLED": {
                      "isOptional": false,
                      "description": "Create the admin account on first boot",
                      "defaultValue": "true"
                    },
                    "BOOTSTRAP_ADMIN_PASSWORD": {
                      "isOptional": false,
                      "description": "Password of the first admin account (username: admin). Only used when the account is first created - change it later in the UI.",
                      "defaultValue": "{{BOOTSTRAP_ADMIN_PASSWORD}}"
                    },
                    "BOOTSTRAP_ADMIN_USERNAME": {
                      "isOptional": false,
                      "description": "Username of the first admin account",
                      "defaultValue": "admin"
                    },
                    "SKILLHUB_PUBLIC_BASE_URL": {
                      "isOptional": false,
                      "description": "Public URL of the registry (the SkillHub web service)",
                      "defaultValue": "https://${{SkillHub.RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "SKILLHUB_STORAGE_PROVIDER": {
                      "isOptional": false,
                      "description": "Skill packages are stored on this service's volume",
                      "defaultValue": "local"
                    },
                    "SPRING_DATASOURCE_PASSWORD": {
                      "isOptional": false,
                      "description": "Postgres password",
                      "defaultValue": "${{Postgres.POSTGRES_PASSWORD}}"
                    },
                    "SPRING_DATASOURCE_USERNAME": {
                      "isOptional": false,
                      "description": "Postgres user",
                      "defaultValue": "${{Postgres.POSTGRES_USER}}"
                    },
                    "SPRING_DATA_REDIS_PASSWORD": {
                      "isOptional": false,
                      "description": "Redis password",
                      "defaultValue": "${{Redis.REDIS_PASSWORD}}"
                    },
                    "SKILLHUB_SERVICE_ENVIRONMENT": {
                      "isOptional": false,
                      "description": "Environment label",
                      "defaultValue": "production"
                    },
                    "SKILLHUB_SECURITY_SCANNER_URL": {
                      "isOptional": false,
                      "description": "Scanner service on the private network",
                      "defaultValue": "http://${{scanner.RAILWAY_PRIVATE_DOMAIN}}:8000"
                    },
                    "SKILLHUB_SECURITY_SCANNER_MODE": {
                      "isOptional": false,
                      "description": "Send packages to the scanner over HTTP",
                      "defaultValue": "upload"
                    },
                    "SKILLHUB_SECURITY_SCANNER_ENABLED": {
                      "isOptional": false,
                      "description": "Scan every uploaded skill with the scanner service before it is published",
                      "defaultValue": "true"
                    },
                    "SKILLHUB_DOWNLOAD_ANON_COOKIE_SECRET": {
                      "isOptional": false,
                      "description": "Signs anonymous download rate-limit cookies",
                      "defaultValue": "{{SKILLHUB_DOWNLOAD_ANON_COOKIE_SECRET}}"
                    },
                    "SKILLHUB_SUITE_REVIEW_WRITES_ENABLED": {
                      "isOptional": false,
                      "description": "Safe with a single server replica",
                      "defaultValue": "true"
                    },
                    "SKILLHUB_AUTH_INITIAL_SELF_REGISTRATION_ENABLED": {
                      "isOptional": false,
                      "description": "Whether anyone can sign up on first boot. Off so a public URL isn't an open registry; the admin can turn it on in the UI.",
                      "defaultValue": "false"
                    }
                  },
                  "networking": {
                    "serviceDomains": {}
                  },
                  "volumeMounts": {
                    "629d0487-7a5c-4bba-9c8e-eec620bc9ba7": {
                      "mountPath": "/var/lib/skillhub/storage"
                    }
                  }
                },
                "8a5a8768-4373-4cd4-ac36-bb239b0b383b": {
                  "icon": "https://devicons.railway.app/i/postgresql.svg",
                  "name": "Postgres",
                  "build": {},
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "postgres:16.15-alpine"
                  },
                  "variables": {
                    "PGDATA": {
                      "isOptional": false,
                      "description": "Data subdirectory - keeps Postgres happy on Railway volumes",
                      "defaultValue": "/var/lib/postgresql/data/pgdata"
                    },
                    "POSTGRES_DB": {
                      "isOptional": false,
                      "description": "Database name",
                      "defaultValue": "skillhub"
                    },
                    "POSTGRES_USER": {
                      "isOptional": false,
                      "description": "Database user",
                      "defaultValue": "skillhub"
                    },
                    "POSTGRES_PASSWORD": {
                      "isOptional": false,
                      "description": "Auto-generated database password",
                      "defaultValue": "{{POSTGRES_PASSWORD}}"
                    },
                    "RAILWAY_DEPLOYMENT_DRAINING_SECONDS": {
                      "isOptional": false,
                      "description": "Time for Postgres to shut down cleanly on redeploy",
                      "defaultValue": "60"
                    }
                  },
                  "networking": {
                    "serviceDomains": {}
                  },
                  "volumeMounts": {
                    "b636d9f5-d685-4a9b-b557-36351a4d0117": {
                      "mountPath": "/var/lib/postgresql/data"
                    }
                  }
                },
                "a6effc69-390d-4a5a-afb9-dd93e23df4d1": {
                  "icon": "https://devicons.railway.app/i/redis.svg",
                  "name": "Redis",
                  "build": {},
                  "deploy": {
                    "startCommand": "/bin/sh -c \"chown -R redis:redis /data && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --appendonly yes\"",
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "redis:8.10.2-alpine"
                  },
                  "variables": {
                    "REDIS_PASSWORD": {
                      "isOptional": false,
                      "description": "Auto-generated Redis password",
                      "defaultValue": "{{REDIS_PASSWORD}}"
                    }
                  },
                  "networking": {
                    "serviceDomains": {}
                  },
                  "volumeMounts": {
                    "7f3e1a14-cb84-423e-9edd-940d36b9a801": {
                      "mountPath": "/data"
                    }
                  }
                },
                "b1c39543-8337-4d70-975f-58f6c173e594": {
                  "icon": "https://raw.githubusercontent.com/nomideusz/skillhub-railway/main/icon.png",
                  "name": "SkillHub",
                  "build": {
                    "dockerfilePath": "Dockerfile"
                  },
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": "/nginx-health",
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "https://github.com/nomideusz/skillhub-railway",
                    "rootDirectory": null
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "nginx port behind the Railway domain - leave as is",
                      "defaultValue": "80"
                    },
                    "SKILLHUB_ALLOW_SIGNUP": {
                      "isOptional": false,
                      "description": "Let anyone with the URL create an account. Off by default: the admin creates accounts, or you set this to true and redeploy.",
                      "defaultValue": "false"
                    },
                    "SKILLHUB_API_UPSTREAM": {
                      "isOptional": false,
                      "description": "Where nginx forwards /api - the server service on the private network",
                      "defaultValue": "http://${{server.RAILWAY_PRIVATE_DOMAIN}}:8080"
                    },
                    "SKILLHUB_PUBLIC_BASE_URL": {
                      "isOptional": false,
                      "description": "Public URL of this registry, used in the agent install guide",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "SKILLHUB_TRUST_FORWARDED_PROTO": {
                      "isOptional": false,
                      "description": "Trust Railway's edge X-Forwarded-Proto so login cookies and redirects use https",
                      "defaultValue": "true"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>:80": {
                        "port": 80
                      }
                    }
                  },
                  "volumeMounts": {}
                },
                "ded164b2-0a64-4d65-8328-a4b728270439": {
                  "icon": "https://raw.githubusercontent.com/nomideusz/skillhub-railway/main/icon.png",
                  "name": "scanner",
                  "build": {},
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": "/health",
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "ghcr.io/iflytek/skillhub-scanner:v0.2.22"
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "Scanner port - leave as is",
                      "defaultValue": "8000"
                    },
                    "SKILL_SCANNER_LLM_MODEL": {
                      "isOptional": true,
                      "description": "Optional: model for the scanner's LLM analyzer",
                      "defaultValue": ""
                    },
                    "SKILL_SCANNER_LLM_API_KEY": {
                      "isOptional": true,
                      "description": "Optional: API key for the scanner's LLM analyzer",
                      "defaultValue": ""
                    },
                    "SKILL_SCANNER_LLM_BASE_URL": {
                      "isOptional": true,
                      "description": "Optional: base URL for an OpenAI-compatible LLM endpoint",
                      "defaultValue": ""
                    },
                    "SKILLHUB_SCANNER_MAX_CONCURRENT_SCANS": {
                      "isOptional": false,
                      "description": "Scans running at once",
                      "defaultValue": "1"
                    }
                  },
                  "networking": {
                    "serviceDomains": {}
                  },
                  "volumeMounts": {}
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {
    "healthcheck": {
      "service": "SkillHub",
      "method": "GET",
      "path": "/nginx-health",
      "expect_status": 200
    }
  },
  "resources": {
    "expected_services": 5,
    "needs_volume": true
  },
  "generated_at": "2026-10-16T16:14:45.804Z",
  "generator_version": "0.1.0",
  "status": "validated",
  "validated_at": "2026-10-16T15:50:15.888Z",
  "success_rate_30d": 1,
  "validation": {
    "last_run_id": "run_efb63718420f4482ae39",
    "checks": [
      {
        "name": "workflow_completed",
        "passed": true
      },
      {
        "name": "all_services_deployed",
        "passed": true
      },
      {
        "name": "healthcheck",
        "passed": true
      },
      {
        "name": "stays_up",
        "passed": true
      }
    ],
    "typical_ready_seconds": 88,
    "typical_build_seconds": 0,
    "typical_start_seconds": 50,
    "slowest_service": "server"
  }
}