--- title: "Deploy Typebot Builder and Viewer Stack" description: "Chatbot builder and viewer with Postgres, Valkey and S3-compatible files." category: "Automation" url: https://railway.com/deploy/typebot-builder-and-viewer-stack --- # Deploy Typebot Builder and Viewer Stack Chatbot builder and viewer with Postgres, Valkey and S3-compatible files. **[Deploy Typebot Builder and Viewer Stack on Railway](https://railway.com/template/typebot-builder-and-viewer-stack)** Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/typebot-builder-and-viewer-stack/manifest.json - **Creator:** dankeewithtwoes's Projects - **Category:** Automation ## Template content ### MinIO https://res.cloudinary.com/h5kvzw/image/upload/v1706062979/MINIO_Bird_vbtpet.png - **Source:** railwayapp-templates/minio - **Start command:** `/bin/sh -c "exec minio server --address [::]:$PORT $RAILWAY_VOLUME_MOUNT_PATH"` - **Health check:** /minio/health/ready - **Public domain:** Yes ### Viewer https://raw.githubusercontent.com/baptisteArno/typebot.io/b0d1b113259c4e820f0b5e45d3b2d45df5776513/apps/docs/static/img/logo.svg - **Image:** baptistearno/typebot-viewer@sha256:9658d71b8310df97df4d48e5f1e8f159b70d738e8e33c5a087cda1d498278a5c - **Health check:** / - **Public domain:** Yes ### Builder https://raw.githubusercontent.com/baptisteArno/typebot.io/b0d1b113259c4e820f0b5e45d3b2d45df5776513/apps/docs/static/img/logo.svg - **Image:** baptistearno/typebot-builder@sha256:5483d1b4e030e6419ccde98cb0b935ca51e127a7d656c55121d66e8fe9ccf8f4 - **Health check:** /signin - **Public domain:** Yes ### Valkey https://res.cloudinary.com/h5kvzw/image/upload/v1713278076/Valkey-logo_yrnlsx.svg - **Image:** valkey/valkey@sha256:418652cfb58ef879d4978c33553735d7147016032d5aefaa14c828e611eb9dfd - **Start command:** `/bin/sh -c "exec docker-entrypoint.sh valkey-server --port ${VALKEY_PORT} --requirepass ${VALKEY_PASSWORD}"` ### Postgres https://devicons.railway.app/i/postgresql.svg - **Image:** ghcr.io/railwayapp-templates/postgres-ssl@sha256:34c3e49e7ed2aaef6c575fb23bb37b878007e97752d3bf27ccb550046f893ca7 ### Console https://res.cloudinary.com/h5kvzw/image/upload/v1706062979/MINIO_Bird_vbtpet.png - **Source:** railwayapp-templates/minio-console - **Start command:** `/bin/sh -c "exec console server --host 0.0.0.0 --port $PORT"` - **Health check:** /login - **Public domain:** Yes ### MinIO Bucket Creator https://res.cloudinary.com/h5kvzw/image/upload/v1706062979/MINIO_Bird_vbtpet.png - **Image:** curlimages/curl@sha256:a134550be58ab783810e613ae96fd253c38f7bdd16d9bf9be350700c7a29ac06 - **Start command:** `/bin/sh -c 'set -eu curl --fail --location --retry 3 --output /tmp/mc "$MC_DOWNLOAD_URL" printf '"'"'%s /tmp/mc '"'"' "$MC_SHA256" | sha256sum -c - chmod +x /tmp/mc i=0 until /tmp/mc alias set local "$MINIO_ENDPOINT" "$MINIO_ROOT_USER" "$MINIO_ROOT_PASSWORD" >/dev/null 2>&1 && /tmp/mc ready local >/dev/null 2>&1; do i=$((i + 1)); [ "$i" -lt 60 ] || exit 1; sleep 2 done /tmp/mc mb --ignore-existing "local/$MINIO_BUCKET" /tmp/mc anonymous set download "local/$MINIO_BUCKET/public" '` ## Documentation # Deploy and Host Typebot Builder and Viewer Stack on Railway Chatbot builder and viewer with Postgres, Valkey and S3-compatible files. ## About Hosting Typebot Builder and Viewer Stack This deployment fork provisions Valkey, MinIO, Console, Postgres, Builder, Viewer, MinIO Bucket Creator. Application domains and any authored TCP endpoints are generated for each new deployment. Database and queue services are private by default. ## Why Deploy Typebot Builder and Viewer Stack on Railway - New setup and maintenance documentation with attribution to the original template. - Public container sources are locked by image digest and public Git repositories by commit SHA. - Database and queue services use private networking; external database access is an explicit deployer choice. - Resolved the missing MinIO endpoint reference. - Replaced an unavailable mc image with a checksum-verified official CLI download; bucket creation is idempotent and public assets are read-only. ## Common Use Cases - Build a conversational contact or onboarding flow. - Publish interactive chatbots. - Store bot responses and uploaded assets. ## Dependencies for Typebot Builder and Viewer Stack - A Railway account with capacity for 7 service definitions and the authored storage. - Your own external accounts and credentials when an integration or model provider is needed. No paid provider subscription is included. - Required inputs at deployment: `Builder.SMTP_HOST`, `Builder.SMTP_PASSWORD`, `Builder.SMTP_USERNAME`. ## First Launch Before deploy, supply Builder.SMTP_HOST, SMTP_USERNAME and SMTP_PASSWORD for your own mail provider. Wait for the builder, viewer, databases and MinIO. The initializer creates the bucket and exits. Sign in through the Builder domain, create a bot, then publish it to the Viewer. ## Included Services and Storage | Service | Persistent paths | | --- | --- | | Valkey | `/data` | | MinIO | `/data` | | Console | No attached volume | | Postgres | `/var/lib/postgresql/data` | | Builder | No attached volume | | Viewer | No attached volume | | MinIO Bucket Creator | No attached volume | ## Operations Builder and Viewer share the encryption secret, database and bucket. Back up PostgreSQL and MinIO. The public assets prefix permits anonymous downloads only; writes require S3 credentials. This is a multi-service stack with mail-provider configuration required. Railway bills the deployer for actual services, storage and network use. Back up persistent data before source/version changes. This publication was checked against Railway's configuration schema and upstream source/registry availability; a full runtime deployment test has not been performed. ## Attribution and Source Based on [Typebot](https://railway.com/template/typebot) by Brody's Projects. It appeared at position 13 in Railway's backend Popular/browse results captured on 2026-10-18, with 4,100 deployments reported for the original. That count belongs to the original, not this new fork. The original software and repositories remain owned by their upstream authors and retain their licenses. This is a deployment configuration fork with new documentation, not a claim of software authorship or official vendor affiliation. Application source: [railwayapp-templates/minio](https://github.com/railwayapp-templates/minio) · [railwayapp-templates/minio-console](https://github.com/railwayapp-templates/minio-console). Fork/eject the repository before making your own code changes. For template wiring issues, use this template's discussion link and share redacted logs. Never post passwords, API keys or login tokens. ## Deploy this recipe [![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/new/template/typebot-builder-and-viewer-stack?utm_source=railway-marketplace&utm_medium=listing&utm_campaign=toolkit-discovery&utm_content=typebot-builder-viewer-stack) Review the required inputs and hosting resource costs before deploying. ### Related deployment recipes - [n8n with PostgreSQL & Durable Storage](https://railway.com/template/n8n-with-postgresql-and-durable-storage) — Workflow automation with private Postgres, durable files and webhook URLs. - [NocoDB with PostgreSQL, Redis & Files](https://railway.com/template/nocodb-with-postgresql-redis-and-files) — No-code tables, forms and APIs with Postgres, Redis and durable files. - [Gotenberg PDF API with Authentication](https://railway.com/template/gotenberg-pdf-api-with-authentication) — PDF conversion API with generated Basic Auth and private URL filtering. These are separate deployments; no preconfigured integration between the applications is implied. Disclosure: this template is maintained independently. Its maintainer may earn Railway usage kickbacks when other people deploy it. Railway bills hosting separately; no paid software subscription or provider credits are included. ## Similar templates - [N8N Main + Worker](https://railway.com/deploy/n8n-main-worker) — Deploy and Host N8N with Inactive worker. - [Evolution API with n8n](https://railway.com/deploy/evolution-api-with-n8n) — Automate WhatsApp workflows with Evolution API, n8n, and Postgres. - [Postgres Backup](https://railway.com/deploy/postgres-s3-backups) — Cron-based PostgreSQL backup to bucket storage Open this page in a browser: https://railway.com/deploy/typebot-builder-and-viewer-stack