Deploy and Host AgentHook

Deploy AgentHook as a private, single-tenant operator console with a managed Railway MySQL service.

About Hosting

This template creates two services: agenthook and MySQL. Enter only SINGLE_TENANT_OWNER_EMAIL; Railway generates MYSQL_ROOT_PASSWORD, wires AgentHook to the private MySQL service, and exposes that generated value to AgentHook as SINGLE_TENANT_ADMIN_SECRET. On first boot AgentHook creates the railway database if needed and runs embedded schema migrations.

Why Deploy

AgentHook gives a partner-owned Railway workspace a private webhook listener, API-token console, listener management, event storyboard, and durable MySQL-backed storage without requiring ScaleKit or the hosted multi-tenant landing flow.

Common Use Cases

• Deploy a private webhook intake service for a partner or customer environment.
• Generate API tokens and listener secrets from a single owner console.
• Receive webhook events on the Railway or partner custom domain and inspect them in Storyboard.
• Keep data persistent across redeploys using the bundled Railway MySQL volume.

Dependencies for AgentHook

AgentHook depends on a MySQL-compatible database. This template includes a MySQL service by default and wires COMMERCE_MYSQL_DSN internally, so installers do not need to enter database host, port, user, password, or database values.

Deployment Dependencies

The only required installer value is SINGLE_TENANT_OWNER_EMAIL. After deployment, open the agenthook service variables, copy SINGLE_TENANT_ADMIN_SECRET, open the deployed service URL, and enter the secret to log in as owner. The default template maps this to the generated MySQL root password so Railway can keep the setup one-field; rotate SINGLE_TENANT_ADMIN_SECRET after deployment if you want a separate app-login secret. For partner installs, add a custom domain in Railway and optionally set PUBLIC_BASE_URL=https://your-domain.example after deployment so generated webhook examples use the partner domain. Do not enable USE_IN_MEMORY_STORE=true for production because that mode is demo-only and non-persistent.