AgentHook Single-Tenant Railway Template

This template deploys AgentHook as a private, single-tenant Railway service with a managed Railway MySQL database.

What Railway creates

• agenthook: the AgentHook web/API service from the connected GitHub repository.
• MySQL: a Railway-managed MySQL service with a persistent volume.

AgentHook receives COMMERCE_MYSQL_DSN=${{MySQL.MYSQL_URL}}, so it connects to the Railway-created database automatically. On startup, AgentHook runs the embedded SQL migrations and fails fast if the schema cannot be initialized.

Required partner inputs

Set these during template deployment:

• PUBLIC_BASE_URL: the partner custom domain, for example https://hooks.partner.com.
• APP_SESSION_SECRET: a strong random session secret.
• SINGLE_TENANT_OWNER_EMAIL: the owner/operator email for the tenant.
• SINGLE_TENANT_OWNER_ALIAS: display alias for the owner/operator.
• SINGLE_TENANT_SETUP_TOKEN_SHA256: SHA-256 hash of the setup token the owner will use for first login.

The intended fixed values are:

• APP_DEPLOYMENT_MODE=single_tenant
• APP_PLAN=enterprise
• ALLOW_PUBLIC_REGISTRATION=false
• USE_IN_MEMORY_STORE=false
• VERIFY_HTC_SIGNATURE=false
• PINECONE_ENABLED=false
• DETERMINISTIC_ONLY_TYPE_KEYS=ai-recruiter-inbox-message

Database behavior

The default path uses Railway MySQL. You do not need to manually create tables. AgentHook initializes and upgrades the schema during service startup.

Advanced users can override COMMERCE_MYSQL_DSN after deployment to point AgentHook at an external MySQL database. The same startup migrations will run there as well.

Do not use USE_IN_MEMORY_STORE=true for production. It is demo-only and does not persist data across restarts.

Login flow

This template is for single-tenant installs. The owner logs in with the setup token on the home page. ScaleKit is intentionally not required for this flow.