Build chatbots visually, embed them anywhere, and keep the data in your own database. This repo is the Blueprint. The app runs from the official Typebot Docker images.
This repository does not contain the Typebot source. Both services pull the official images from Docker Hub at a pinned version. To upgrade, change the tag in render.yaml and push. The Blueprint redeploys both services.
| Piece | Role |
|---|---|
| Typebot | Visual chatbot builder with a chat API, embeds, webhooks, and OpenAI, Sheets, and Zapier blocks. |
typebot-builder (Web Service) |
Editor, dashboard, and API. Runs database migrations on boot. |
typebot-viewer (Web Service) |
Serves published bots and the chat API that embeds call. |
typebot-db (Render Postgres) |
Bots, results, users, and encrypted credentials. |
flowchart LR
you["You"] -->|edit bots| builder["typebot-builder"]
visitor["Site visitors"] -->|chat| viewer["typebot-viewer"]
builder --> db[("typebot-db")]
viewer --> db
builder -->|magic link| smtp["Your SMTP provider"]
hub["Docker Hub: baptistearno/typebot-*:3.19.1"] --> builder
hub --> viewer
- Click Deploy to Render. The flow copies this repo into your GitHub account and applies
render.yaml. - On Apply, fill in
ADMIN_EMAILand your SMTP settings. Render creates the database, generates the encryption key, and wires each service's public URL into the other. - The builder runs
prisma migrate deploy, then starts. The viewer starts beside it. - Open the
typebot-builderURL, enterADMIN_EMAIL, and click the sign-in link in your inbox. That account gets an unlimited workspace.
| Resource | Type | Plan | Notes |
|---|---|---|---|
typebot-builder |
Web, image | Starter | baptistearno/typebot-builder:3.19.1 |
typebot-viewer |
Web, image | Starter | baptistearno/typebot-viewer:3.19.1 |
typebot-db |
Postgres 16 | Basic 256 MB | Internal connections only. |
Default region: Oregon.
- A Render account
- SMTP credentials for sign-in emails. Any provider works, for example Resend, Postmark, SendGrid, or Amazon SES.
- Click Deploy to Render above.
- Fill in
ADMIN_EMAIL,SMTP_HOST,SMTP_USERNAME,SMTP_PASSWORD, andNEXT_PUBLIC_SMTP_FROM. - Wait until
typebot-builderandtypebot-viewerare Live. - Open the builder URL and sign in with
ADMIN_EMAIL. - Optional: set
DISABLE_SIGNUP=trueontypebot-builderso only invited users can join.
| Variable | Service | Source | Description |
|---|---|---|---|
ADMIN_EMAIL |
builder | Required | Gets an unlimited workspace. Comma-separate several. |
SMTP_HOST, SMTP_USERNAME, SMTP_PASSWORD |
builder | Required | Sends sign-in links and notifications. |
NEXT_PUBLIC_SMTP_FROM |
builder | Required | Sender, e.g. 'Typebot' <typebot@example.com>. |
SMTP_PORT |
builder | Blueprint | 587. Use 465 with SMTP_SECURE=true. |
DATABASE_URL |
both | Wired | Internal URL of typebot-db. |
ENCRYPTION_SEED |
both | Generated | Shared random value. Each service exports its first 32 characters as ENCRYPTION_SECRET. Do not change it after you save credentials. |
NEXTAUTH_URL |
both | Wired | Builder RENDER_EXTERNAL_URL. |
NEXT_PUBLIC_VIEWER_URL |
both | Wired | Viewer RENDER_EXTERNAL_URL. |
DISABLE_SIGNUP |
builder | Optional | true blocks new sign-ups. Invited users can still join. |
GITHUB_CLIENT_ID, GOOGLE_AUTH_CLIENT_ID, … |
builder | Optional | Other sign-in providers. See the upstream configuration. |
S3_* |
both | Optional | File uploads in bots and media in the editor. |
REDIS_URL |
both | Optional | Turns on rate limiting. Point it at a Render Key Value instance. |
Typebot requires ENCRYPTION_SECRET to be exactly 32 characters, and the builder and viewer must share it. Render's generateValue returns a longer string. The Blueprint generates ENCRYPTION_SEED once on the builder, copies it to the viewer, and each service's start command exports the first 32 characters before it runs the upstream entrypoint.
Prices from Render's pricing page.
| Resource | Approx. monthly |
|---|---|
typebot-builder (Starter) |
$7 |
typebot-viewer (Starter) |
$7 |
typebot-db (Basic 256 MB) |
$6 |
| Total | ~$20 |
Starter fits a small team. In testing, one person editing and publishing a bot took the builder to about 370 MB of its 512 MB. Move typebot-builder to Standard (+$18) for heavier editing. The viewer used about 220 MB.
| Problem | Solution |
|---|---|
| No sign-in email arrives | Check the SMTP values on typebot-builder and its logs. Set TYPEBOT_DEBUG=true for more detail. |
ENCRYPTION_SECRET validation error on boot |
ENCRYPTION_SEED is missing or shorter than 32 characters. Check it on both services. |
| Bots fail with credential errors after you rotated the key | Credentials are encrypted with the old key. Restore the old ENCRYPTION_SEED or re-add the credentials. |
| Published bot links point at the wrong host | NEXT_PUBLIC_VIEWER_URL must be the viewer's public URL. Update it after you add a custom domain, on both services. |
| OOM restarts on the builder | The editor is memory-heavy. Move typebot-builder to Standard. |
render.yaml Blueprint. Two image-backed web services and Postgres.
README.md This file
LICENSE Wrapper license
.env.example Values the deploy form asks for, and optional extras
MIT for this wrapper.
Typebot is licensed under the Functional Source License, Version 1.1, Apache 2.0 Future License. You can self-host it for your own use. You cannot offer it to others as a commercial product that competes with Typebot. Each release converts to Apache 2.0 two years after it ships.