Deploy and Host Typebot on Railway

Typebot is a source-available (fair source) chatbot builder. You design conversations in a visual flow editor with text, image and video bubbles, inputs, conditions, webhooks and AI blocks. Then you publish each bot as a standalone page, or embed it as a chat bubble or popup on any website.

About Hosting Typebot

Typebot runs as two Next.js apps. The builder is the editor and dashboard; the viewer serves your published bots. Both use Postgres for bots and results, and Redis for rate limits and result exports. Both also need the same 32-character encryption key, and each needs the other's public URL. Sign-in works by e-mail code or OAuth only (there are no passwords), so an SMTP server is required. Uploaded images and file answers go to S3-compatible storage that serves public/ files without login. This template wires all of that together: the two apps, Postgres, Redis, a Mailpit inbox for sign-in codes, and RustFS storage on a volume.

Common Use Cases

Lead capture and qualification forms that feel like a conversation
Customer support and FAQ bots embedded on a website, with optional OpenAI or other AI blocks
Quizzes, surveys and onboarding flows that send results to webhooks, Google Sheets or e-mail

Dependencies for Typebot Hosting

PostgreSQL (bots, users and results) and Redis (rate limits, background exports)
An SMTP server for sign-in codes (Mailpit is included) and S3-compatible storage for uploads (RustFS is included)

Deployment Dependencies

Typebot source and releases: https://github.com/baptisteArno/typebot.io/releases/tag/v3.19.1
Typebot self-hosting configuration: https://docs.typebot.io/self-hosting/configuration
Mailpit: https://mailpit.axllent.org/docs/
RustFS: https://github.com/rustfs/rustfs

Implementation Details

First sign-in. Before you deploy, set ADMIN_EMAIL to your e-mail address. Then:

Open the Builder URL, enter that address and press Submit.
Open the Mailpit URL. The login is MAILPIT_USERNAME / MAILPIT_PASSWORD, from the Mailpit service's Variables tab.
Copy the 6-digit code from the "Sign in to Typebot" e-mail, or click its link.

The admin account gets the UNLIMITED plan. DISABLE_SIGNUP defaults to true, so other people can join only when you invite them from your workspace settings.

Real e-mail. Mailpit catches every e-mail Typebot sends and never delivers it. That includes sign-in codes, invitations and the Send Email block's default sender. To send real e-mail, set these variables on both the Builder and the Viewer: SMTP_HOST, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD, NEXT_PUBLIC_SMTP_FROM (e.g. 'Typebot' ), and SMTP_SECURE=true for port 465. Set SMTP_IGNORE_TLS=false too. You can then delete the Mailpit service. Mailpit can also relay to a real server instead; see its docs.

Defaults set in the start command. These apply unless you add the variable yourself: DISABLE_SIGNUP=true, SMTP_PORT=1025, SMTP_IGNORE_TLS=true, NEXT_PUBLIC_SMTP_FROM='Typebot ', S3_BUCKET=typebot, S3_PORT=9000, S3_SSL=false, S3_REGION=us-east-1. Any other option from the configuration docs, such as Google or GitHub sign-in, OpenAI or WhatsApp, can be added as a variable on both apps.

Storage. On first start, RustFS creates the typebot bucket. Anyone can read files under public/, and nothing else in the bucket is public. Uploads go through the viewer's signed upload URL, so no CORS setup is needed. To use AWS S3, R2 or another provider instead, point the S3_* variables of both apps at it.

Custom domains. After adding your own domains, update NEXTAUTH_URL and NEXT_PUBLIC_VIEWER_URL on both apps.

Typebot is licensed under the Functional Source License (FSL 1.1, Apache 2.0 future license). Self-hosting for your own use is allowed; read the license before offering it as a competing service.

Why Deploy Typebot on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Typebot on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.