{ "manifest_version": "1.0.0", "template": { "id": "177bf4ea-4206-45c2-93f4-d2b1c2147745", "slug": "romm", "name": "romm", "description": "A beautiful self-hosted ROM manager and player", "url": "https://railway.com/deploy/romm", "upstream": { "repo_url": "https://github.com/osbytes/template-romm" } }, "services": [ { "name": "app", "source": { "repo": "https://github.com/osbytes/template-romm" }, "needs_volume": true, "volume_mount_path": "/romm", "http": true }, { "name": "mariadb", "source": { "image": "mariadb:11.4" }, "needs_volume": true, "volume_mount_path": "/var/lib/mysql", "http": false } ], "required_inputs": [ { "key": "DB_HOST", "service": "app", "description": "MariaDB private DNS — not the public URL", "secret": false, "strategy": "railway_provided", "railway_source": "railway_private_domain" }, { "key": "DB_NAME", "service": "app", "description": "Database name; must match MariaDB service", "secret": false, "strategy": "railway_provided", "railway_source": "reference_variable" }, { "key": "DB_PORT", "service": "app", "description": "MariaDB port on private networking", "secret": false, "strategy": "default", "default": "3306" }, { "key": "DB_USER", "service": "app", "description": "Database user; must match MariaDB service", "secret": false, "strategy": "railway_provided", "railway_source": "reference_variable" }, { "key": "DB_PASSWD", "service": "app", "description": "Database password; must match MariaDB service", "secret": false, "strategy": "railway_provided", "railway_source": "reference_variable" }, { "key": "ROMM_PORT", "service": "app", "description": "Container HTTP port; match public networking target", "secret": false, "strategy": "default", "default": "8080" }, { "key": "REDIS_HOST", "service": "app", "description": "Use Valkey embedded in the RomM image (same as upstream Compose)", "secret": false, "strategy": "default", "default": "127.0.0.1" }, { "key": "REDIS_PORT", "service": "app", "description": "Embedded Valkey listen port", "secret": false, "strategy": "default", "default": "6379" }, { "key": "OIDC_ENABLED", "service": "app", "description": "Enable only when wiring an external IdP", "secret": false, "strategy": "default", "default": "false" }, { "key": "ROMM_BASE_URL", "service": "app", "description": "Public HTTPS URL of this instance (no trailing slash)", "secret": false, "strategy": "railway_provided", "railway_source": "railway_domain" }, { "key": "ROMM_BASE_PATH", "service": "app", "description": "Base path for library, resources, assets, and config", "secret": false, "strategy": "default", "default": "/romm" }, { "key": "ROMM_DB_DRIVER", "service": "app", "description": "Database driver (keep mariadb for this template)", "secret": false, "strategy": "default", "default": "mariadb" }, { "key": "HASHEOUS_API_ENABLED", "service": "app", "description": "Enable Hasheous metadata lookups (no API key required)", "secret": false, "strategy": "default", "default": "true" }, { "key": "ROMM_AUTH_SECRET_KEY", "service": "app", "description": "App signing secret; do not rotate after first deploy", "secret": true, "strategy": "generate", "generate": "random_base64_32" }, { "key": "LAUNCHBOX_API_ENABLED", "service": "app", "description": "Optional LaunchBox metadata integration", "secret": false, "strategy": "default", "default": "false" }, { "key": "PLAYMATCH_API_ENABLED", "service": "app", "description": "Optional PlayMatch metadata integration", "secret": false, "strategy": "default", "default": "false" }, { "key": "ROMM_SESSION_SECURE_COOKIE", "service": "app", "description": "Mark cookies Secure when served over Railway HTTPS", "secret": false, "strategy": "default", "default": "true" }, { "key": "MARIADB_USER", "service": "mariadb", "description": "Database user referenced by app DB_USER", "secret": false, "strategy": "default", "default": "romm" }, { "key": "MARIADB_DATABASE", "service": "mariadb", "description": "Database name referenced by app DB_NAME", "secret": false, "strategy": "default", "default": "romm" }, { "key": "MARIADB_PASSWORD", "service": "mariadb", "description": "Database password; keep in sync with app DB_PASSWD", "secret": true, "strategy": "generate", "generate": "strong_password" }, { "key": "MARIADB_ROOT_PASSWORD", "service": "mariadb", "description": "MariaDB root password (not used by the app)", "secret": true, "strategy": "generate", "generate": "strong_password" } ], "deploy": { "mcp": { "server": "railway", "tool": "deploy_template", "args": { "template_code": "romm" } }, "cli": "railway deploy --template romm", "api": { "method": "POST", "path": "/graphql/v2", "body": { "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }", "variables": { "input": { "templateId": "177bf4ea-4206-45c2-93f4-d2b1c2147745", "serializedConfig": { "services": { "5bfac22f-eaaf-45a8-b23f-f85d7300bb42": { "icon": "https://raw.githubusercontent.com/osbytes/template-romm/27de346bead2d02ab4ed52c20e4ff7ac63b2621c/assets/logo.svg", "name": "app", "deploy": { "healthcheckPath": "/api/heartbeat" }, "source": { "repo": "osbytes/template-romm", "branch": null, "rootDirectory": "/services/app" }, "variables": { "DB_HOST": { "description": "MariaDB private DNS — not the public URL", "defaultValue": "${{mariadb.RAILWAY_PRIVATE_DOMAIN}}" }, "DB_NAME": { "description": "Database name; must match MariaDB service", "defaultValue": "${{mariadb.MARIADB_DATABASE}}" }, "DB_PORT": { "description": "MariaDB port on private networking", "defaultValue": "3306" }, "DB_USER": { "description": "Database user; must match MariaDB service", "defaultValue": "${{mariadb.MARIADB_USER}}" }, "DB_PASSWD": { "description": "Database password; must match MariaDB service", "defaultValue": "${{mariadb.MARIADB_PASSWORD}}" }, "ROMM_PORT": { "description": "Container HTTP port; match public networking target", "defaultValue": "8080" }, "REDIS_HOST": { "description": "Use Valkey embedded in the RomM image (same as upstream Compose)", "defaultValue": "127.0.0.1" }, "REDIS_PORT": { "description": "Embedded Valkey listen port", "defaultValue": "6379" }, "OIDC_ENABLED": { "description": "Enable only when wiring an external IdP", "defaultValue": "false" }, "ROMM_BASE_URL": { "description": "Public HTTPS URL of this instance (no trailing slash)", "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}" }, "IGDB_CLIENT_ID": { "isOptional": true, "description": "Optional IGDB client ID (Twitch developer credentials)", "defaultValue": "" }, "OIDC_CLIENT_ID": { "isOptional": true, "description": "OIDC client id when OIDC_ENABLED=true", "defaultValue": "" }, "ROMM_BASE_PATH": { "description": "Base path for library, resources, assets, and config", "defaultValue": "/romm" }, "ROMM_DB_DRIVER": { "description": "Database driver (keep mariadb for this template)", "defaultValue": "mariadb" }, "MOBYGAMES_API_KEY": { "isOptional": true, "description": "Optional MobyGames API key", "defaultValue": "" }, "OIDC_REDIRECT_URI": { "isOptional": true, "description": "Absolute callback URL, usually https:///api/oauth/openid", "defaultValue": "" }, "IGDB_CLIENT_SECRET": { "isOptional": true, "description": "Optional IGDB client secret", "defaultValue": "" }, "OIDC_CLIENT_SECRET": { "isOptional": true, "description": "OIDC client secret when OIDC_ENABLED=true", "defaultValue": "" }, "SCREENSCRAPER_USER": { "isOptional": true, "description": "Optional Screenscraper username for richer metadata", "defaultValue": "" }, "STEAMGRIDDB_API_KEY": { "isOptional": true, "description": "Optional SteamGridDB API key", "defaultValue": "" }, "HASHEOUS_API_ENABLED": { "description": "Enable Hasheous metadata lookups (no API key required)", "defaultValue": "true" }, "ROMM_AUTH_SECRET_KEY": { "description": "App signing secret; do not rotate after first deploy", "defaultValue": "{{ROMM_AUTH_SECRET_KEY}}" }, "LAUNCHBOX_API_ENABLED": { "description": "Optional LaunchBox metadata integration", "defaultValue": "false" }, "PLAYMATCH_API_ENABLED": { "description": "Optional PlayMatch metadata integration", "defaultValue": "false" }, "SCREENSCRAPER_PASSWORD": { "isOptional": true, "description": "Optional Screenscraper password", "defaultValue": "" }, "RETROACHIEVEMENTS_API_KEY": { "isOptional": true, "description": "Optional RetroAchievements API key", "defaultValue": "" }, "ROMM_SESSION_SECURE_COOKIE": { "description": "Mark cookies Secure when served over Railway HTTPS", "defaultValue": "true" }, "OIDC_SERVER_APPLICATION_URL": { "isOptional": true, "description": "OIDC issuer / application base URL", "defaultValue": "" } }, "networking": { "serviceDomains": { ":8080": { "port": 8080 } } }, "volumeMounts": { "5bfac22f-eaaf-45a8-b23f-f85d7300bb42": { "mountPath": "/romm" } } }, "5d19d7e0-7c54-481b-95b3-89ffdf4ba40a": { "icon": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQhmrCLpifYPHPFANMSxFjjtXIWvg4PcN-9PDPRGIggEWMt6dltFBQbxM0&s=10", "name": "mariadb", "source": { "image": "mariadb:11.4" }, "variables": { "MARIADB_USER": { "description": "Database user referenced by app DB_USER", "defaultValue": "romm" }, "MARIADB_DATABASE": { "description": "Database name referenced by app DB_NAME", "defaultValue": "romm" }, "MARIADB_PASSWORD": { "description": "Database password; keep in sync with app DB_PASSWD", "defaultValue": "{{MARIADB_PASSWORD}}" }, "MARIADB_ROOT_PASSWORD": { "description": "MariaDB root password (not used by the app)", "defaultValue": "{{MARIADB_ROOT_PASSWORD}}" } }, "volumeMounts": { "5d19d7e0-7c54-481b-95b3-89ffdf4ba40a": { "mountPath": "/var/lib/mysql" } } } } } } } } } }, "post_deploy": { "healthcheck": { "service": "app", "method": "GET", "path": "/api/heartbeat", "expect_status": 200 } }, "resources": { "expected_services": 2, "needs_volume": true }, "generated_at": "2026-09-16T04:14:35.474Z", "generator_version": "0.1.0", "status": "degraded", "validated_at": "2026-09-15T05:02:05.030Z", "success_rate_30d": 0, "validation": { "last_run_id": "run_eb36540be9de4ae09f08", "checks": [ { "name": "workflow_completed", "passed": true }, { "name": "all_services_deployed", "passed": false, "detail": "FAILED,SUCCESS" } ] } }