{
  "manifest_version": "1.0.0",
  "template": {
    "id": "7df87943-85dc-4dff-b8ae-7d8babde4077",
    "slug": "isso",
    "name": "Isso",
    "description": "Commenting server that adds a comment box to any web page",
    "url": "https://railway.com/deploy/isso",
    "upstream": {
      "repo_url": "https://github.com/gridalpha/isso-railway"
    }
  },
  "services": [
    {
      "name": "isso",
      "source": {
        "repo": "https://github.com/gridalpha/isso-railway"
      },
      "needs_volume": true,
      "volume_mount_path": "/db",
      "http": true
    },
    {
      "name": "mailpit",
      "source": {
        "image": "axllent/mailpit:latest"
      },
      "needs_volume": true,
      "volume_mount_path": "/data",
      "http": true
    }
  ],
  "required_inputs": [
    {
      "key": "PORT",
      "service": "isso",
      "description": "HTTP port gunicorn binds",
      "secret": false,
      "strategy": "default",
      "default": "8080"
    },
    {
      "key": "ISSO_NOTIFY",
      "service": "isso",
      "description": "Notification backend for new comments",
      "secret": false,
      "strategy": "default",
      "default": "smtp"
    },
    {
      "key": "ISSO_DB_PATH",
      "service": "isso",
      "description": "SQLite database on the volume",
      "secret": false,
      "strategy": "default",
      "default": "/db/comments.db"
    },
    {
      "key": "ISSO_MAX_AGE",
      "service": "isso",
      "description": "Window for editing your own comment",
      "secret": false,
      "strategy": "default",
      "default": "15m"
    },
    {
      "key": "ISSO_SMTP_TO",
      "service": "isso",
      "description": "Recipient of moderation mail",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "ISSO_WORKERS",
      "service": "isso",
      "description": "gunicorn worker processes",
      "secret": false,
      "strategy": "default",
      "default": "4"
    },
    {
      "key": "ISSO_GRAVATAR",
      "service": "isso",
      "description": "Use Gravatar instead of identicons",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "ISSO_HASH_SALT",
      "service": "isso",
      "description": "Salt for stored commenter email hashes",
      "secret": false,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "ISSO_RSS_LIMIT",
      "service": "isso",
      "description": "Entries returned per thread feed",
      "secret": false,
      "strategy": "default",
      "default": "100"
    },
    {
      "key": "ISSO_SMTP_FROM",
      "service": "isso",
      "description": "Sender of notification mail",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "ISSO_SMTP_HOST",
      "service": "isso",
      "description": "SMTP server hostname",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "ISSO_SMTP_PORT",
      "service": "isso",
      "description": "SMTP server port",
      "secret": false,
      "strategy": "default",
      "default": "1025"
    },
    {
      "key": "ISSO_ACCESS_LOG",
      "service": "isso",
      "description": "Write gunicorn access logs to stdout",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "ISSO_MODERATION",
      "service": "isso",
      "description": "Hold new comments for approval",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "ISSO_PURGE_AFTER",
      "service": "isso",
      "description": "Drop unmoderated comments after this",
      "secret": false,
      "strategy": "default",
      "default": "30d"
    },
    {
      "key": "ISSO_ADMIN_ENABLED",
      "service": "isso",
      "description": "Serve the administration page",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "ISSO_GUARD_ENABLED",
      "service": "isso",
      "description": "Enable the built-in spam guard",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "ISSO_SMTP_SECURITY",
      "service": "isso",
      "description": "SMTP transport security",
      "secret": false,
      "strategy": "default",
      "default": "none"
    },
    {
      "key": "ISSO_ADMIN_PASSWORD",
      "service": "isso",
      "description": "Password for the /admin/ page",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "ISSO_LATEST_ENABLED",
      "service": "isso",
      "description": "Expose the cross-thread /latest endpoint",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "ISSO_GUARD_RATELIMIT",
      "service": "isso",
      "description": "New comments per minute per client",
      "secret": false,
      "strategy": "default",
      "default": "2"
    },
    {
      "key": "ISSO_MARKUP_RENDERER",
      "service": "isso",
      "description": "Markdown rendering engine",
      "secret": false,
      "strategy": "default",
      "default": "mistune"
    },
    {
      "key": "ISSO_PUBLIC_ENDPOINT",
      "service": "isso",
      "description": "Public URL Isso is reached at",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "ISSO_GUARD_DIRECT_REPLY",
      "service": "isso",
      "description": "Direct replies allowed per thread",
      "secret": false,
      "strategy": "default",
      "default": "3"
    },
    {
      "key": "ISSO_GUARD_REPLY_TO_SELF",
      "service": "isso",
      "description": "Allow replying to your own comment",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "ISSO_GUARD_REQUIRE_EMAIL",
      "service": "isso",
      "description": "Require an email on every comment",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "ISSO_REPLY_NOTIFICATIONS",
      "service": "isso",
      "description": "Let commenters subscribe to replies",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "ISSO_GUARD_REQUIRE_AUTHOR",
      "service": "isso",
      "description": "Require a name on every comment",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "RAILWAY_DEPLOYMENT_DRAINING_SECONDS",
      "service": "isso",
      "description": "Clean shutdown window",
      "secret": false,
      "strategy": "default",
      "default": "15"
    },
    {
      "key": "ISSO_APPROVE_IF_EMAIL_PREVIOUSLY_APPROVED",
      "service": "isso",
      "description": "Auto-approve known commenters",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "PORT",
      "service": "mailpit",
      "description": "HTTP port the inbox is served on",
      "secret": false,
      "strategy": "default",
      "default": "8025"
    },
    {
      "key": "MP_UI_AUTH",
      "service": "mailpit",
      "description": "Basic auth for the web inbox",
      "secret": false,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "MP_DATABASE",
      "service": "mailpit",
      "description": "Message store on the volume",
      "secret": false,
      "strategy": "default",
      "default": "/data/mailpit.db"
    },
    {
      "key": "MP_MAX_MESSAGES",
      "service": "mailpit",
      "description": "Messages kept before the oldest are dropped",
      "secret": false,
      "strategy": "default",
      "default": "5000"
    },
    {
      "key": "MP_UI_BIND_ADDR",
      "service": "mailpit",
      "description": "Web inbox listen address",
      "secret": false,
      "strategy": "default",
      "default": "0.0.0.0:8025"
    },
    {
      "key": "MP_SMTP_BIND_ADDR",
      "service": "mailpit",
      "description": "SMTP listen address, dual-stack for peers",
      "secret": false,
      "strategy": "default",
      "default": "[::]:1025"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "isso"
      }
    },
    "cli": "railway deploy --template isso",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "7df87943-85dc-4dff-b8ae-7d8babde4077",
            "serializedConfig": {
              "buckets": {},
              "services": {
                "737a1420-777a-4bdf-8039-225459f5de27": {
                  "icon": "https://cdn.jsdelivr.net/gh/isso-comments/isso@0.14.0/isso/img/isso.svg",
                  "name": "isso",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": "/info",
                    "restartPolicyType": "ALWAYS",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "https://github.com/gridalpha/isso-railway",
                    "rootDirectory": null
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "HTTP port gunicorn binds",
                      "defaultValue": "8080"
                    },
                    "ISSO_HOST": {
                      "isOptional": true,
                      "description": "Sites allowed to embed comments",
                      "defaultValue": ""
                    },
                    "ISSO_NOTIFY": {
                      "isOptional": false,
                      "description": "Notification backend for new comments",
                      "defaultValue": "smtp"
                    },
                    "ISSO_DB_PATH": {
                      "isOptional": false,
                      "description": "SQLite database on the volume",
                      "defaultValue": "/db/comments.db"
                    },
                    "ISSO_MAX_AGE": {
                      "isOptional": false,
                      "description": "Window for editing your own comment",
                      "defaultValue": "15m"
                    },
                    "ISSO_SMTP_TO": {
                      "isOptional": false,
                      "description": "Recipient of moderation mail",
                      "defaultValue": "admin@${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "ISSO_WORKERS": {
                      "isOptional": false,
                      "description": "gunicorn worker processes",
                      "defaultValue": "4"
                    },
                    "ISSO_GRAVATAR": {
                      "isOptional": false,
                      "description": "Use Gravatar instead of identicons",
                      "defaultValue": "false"
                    },
                    "ISSO_RSS_BASE": {
                      "isOptional": true,
                      "description": "Atom feed base URL, defaults to first host",
                      "defaultValue": ""
                    },
                    "ISSO_SAMESITE": {
                      "isOptional": true,
                      "description": "Override the session cookie SameSite value",
                      "defaultValue": ""
                    },
                    "ISSO_HASH_SALT": {
                      "isOptional": false,
                      "description": "Salt for stored commenter email hashes",
                      "defaultValue": "{{ISSO_HASH_SALT}}"
                    },
                    "ISSO_RSS_LIMIT": {
                      "isOptional": false,
                      "description": "Entries returned per thread feed",
                      "defaultValue": "100"
                    },
                    "ISSO_SMTP_FROM": {
                      "isOptional": false,
                      "description": "Sender of notification mail",
                      "defaultValue": "Isso <isso@${{RAILWAY_PUBLIC_DOMAIN}}>"
                    },
                    "ISSO_SMTP_HOST": {
                      "isOptional": false,
                      "description": "SMTP server hostname",
                      "defaultValue": "${{mailpit.RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "ISSO_SMTP_PORT": {
                      "isOptional": false,
                      "description": "SMTP server port",
                      "defaultValue": "1025"
                    },
                    "ISSO_ACCESS_LOG": {
                      "isOptional": false,
                      "description": "Write gunicorn access logs to stdout",
                      "defaultValue": "true"
                    },
                    "ISSO_MODERATION": {
                      "isOptional": false,
                      "description": "Hold new comments for approval",
                      "defaultValue": "true"
                    },
                    "ISSO_PURGE_AFTER": {
                      "isOptional": false,
                      "description": "Drop unmoderated comments after this",
                      "defaultValue": "30d"
                    },
                    "ISSO_ADMIN_ENABLED": {
                      "isOptional": false,
                      "description": "Serve the administration page",
                      "defaultValue": "true"
                    },
                    "ISSO_GUARD_ENABLED": {
                      "isOptional": false,
                      "description": "Enable the built-in spam guard",
                      "defaultValue": "true"
                    },
                    "ISSO_SMTP_PASSWORD": {
                      "isOptional": true,
                      "description": "SMTP password, blank for Mailpit",
                      "defaultValue": ""
                    },
                    "ISSO_SMTP_SECURITY": {
                      "isOptional": false,
                      "description": "SMTP transport security",
                      "defaultValue": "none"
                    },
                    "ISSO_SMTP_USERNAME": {
                      "isOptional": true,
                      "description": "SMTP username, blank for Mailpit",
                      "defaultValue": ""
                    },
                    "ISSO_ADMIN_PASSWORD": {
                      "isOptional": false,
                      "description": "Password for the /admin/ page",
                      "defaultValue": "{{ISSO_ADMIN_PASSWORD}}"
                    },
                    "ISSO_LATEST_ENABLED": {
                      "isOptional": false,
                      "description": "Expose the cross-thread /latest endpoint",
                      "defaultValue": "false"
                    },
                    "ISSO_GUARD_RATELIMIT": {
                      "isOptional": false,
                      "description": "New comments per minute per client",
                      "defaultValue": "2"
                    },
                    "ISSO_MARKUP_RENDERER": {
                      "isOptional": false,
                      "description": "Markdown rendering engine",
                      "defaultValue": "mistune"
                    },
                    "ISSO_PUBLIC_ENDPOINT": {
                      "isOptional": false,
                      "description": "Public URL Isso is reached at",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "ISSO_GUARD_DIRECT_REPLY": {
                      "isOptional": false,
                      "description": "Direct replies allowed per thread",
                      "defaultValue": "3"
                    },
                    "ISSO_GUARD_REPLY_TO_SELF": {
                      "isOptional": false,
                      "description": "Allow replying to your own comment",
                      "defaultValue": "false"
                    },
                    "ISSO_GUARD_REQUIRE_EMAIL": {
                      "isOptional": false,
                      "description": "Require an email on every comment",
                      "defaultValue": "false"
                    },
                    "ISSO_REPLY_NOTIFICATIONS": {
                      "isOptional": false,
                      "description": "Let commenters subscribe to replies",
                      "defaultValue": "true"
                    },
                    "ISSO_GUARD_REQUIRE_AUTHOR": {
                      "isOptional": false,
                      "description": "Require a name on every comment",
                      "defaultValue": "false"
                    },
                    "RAILWAY_DEPLOYMENT_DRAINING_SECONDS": {
                      "isOptional": false,
                      "description": "Clean shutdown window",
                      "defaultValue": "15"
                    },
                    "ISSO_APPROVE_IF_EMAIL_PREVIOUSLY_APPROVED": {
                      "isOptional": false,
                      "description": "Auto-approve known commenters",
                      "defaultValue": "false"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>:8080": {
                        "port": 8080
                      }
                    }
                  },
                  "volumeMounts": {
                    "737a1420-777a-4bdf-8039-225459f5de27": {
                      "mountPath": "/db"
                    }
                  }
                },
                "9dcfbe53-4ef0-46ce-972b-988b5dce369a": {
                  "icon": "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/mailpit.svg",
                  "name": "mailpit",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": "/livez",
                    "restartPolicyType": "ALWAYS",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "axllent/mailpit:latest"
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "HTTP port the inbox is served on",
                      "defaultValue": "8025"
                    },
                    "MP_UI_AUTH": {
                      "isOptional": false,
                      "description": "Basic auth for the web inbox",
                      "defaultValue": "{{MP_UI_AUTH}}"
                    },
                    "MP_DATABASE": {
                      "isOptional": false,
                      "description": "Message store on the volume",
                      "defaultValue": "/data/mailpit.db"
                    },
                    "MP_MAX_MESSAGES": {
                      "isOptional": false,
                      "description": "Messages kept before the oldest are dropped",
                      "defaultValue": "5000"
                    },
                    "MP_UI_BIND_ADDR": {
                      "isOptional": false,
                      "description": "Web inbox listen address",
                      "defaultValue": "0.0.0.0:8025"
                    },
                    "MP_SMTP_BIND_ADDR": {
                      "isOptional": false,
                      "description": "SMTP listen address, dual-stack for peers",
                      "defaultValue": "[::]:1025"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>:8025": {
                        "port": 8025
                      }
                    }
                  },
                  "volumeMounts": {
                    "9dcfbe53-4ef0-46ce-972b-988b5dce369a": {
                      "mountPath": "/data"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {
    "healthcheck": {
      "service": "isso",
      "method": "GET",
      "path": "/info",
      "expect_status": 200
    }
  },
  "resources": {
    "expected_services": 2,
    "needs_volume": true
  },
  "generated_at": "2026-09-15T22:14:40.394Z",
  "generator_version": "0.1.0",
  "status": "validated",
  "validated_at": "2026-09-15T19:05:58.531Z",
  "success_rate_30d": 1,
  "validation": {
    "last_run_id": "run_32828809f5c8452c9b82",
    "checks": [
      {
        "name": "workflow_completed",
        "passed": true
      },
      {
        "name": "all_services_deployed",
        "passed": true
      },
      {
        "name": "healthcheck",
        "passed": true
      },
      {
        "name": "stays_up",
        "passed": true
      }
    ],
    "typical_ready_seconds": 99,
    "typical_build_seconds": 72,
    "typical_start_seconds": 10,
    "slowest_service": "isso"
  }
}