How to Self-Host Typebot Conversational Form Builder

What Is Typebot?

Typebot is an open-source conversational form and chatbot builder. It lets you create sophisticated chat-based forms, surveys, and lead generation bots through a visual drag-and-drop interface. Responses can be saved, integrated with external services, or piped into webhooks.

Prerequisites

• A Breeze with at least 2 GB RAM running Ubuntu 22.04+
• Docker and Docker Compose installed
• A domain name pointed to your Breeze

Docker Compose Setup

mkdir -p ~/typebot && cd ~/typebot

version: "3.8"
services:
  typebot-builder:
    image: baptistearno/typebot-builder:latest
    container_name: typebot-builder
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgresql://typebot:TypebotPass123@typebot-db:5432/typebot
      - NEXTAUTH_URL=https://bot.yourdomain.com
      - NEXTAUTH_SECRET=replace-with-random-secret
      - ENCRYPTION_SECRET=replace-with-random-32char

  typebot-viewer:
    image: baptistearno/typebot-viewer:latest
    container_name: typebot-viewer
    restart: unless-stopped
    ports:
      - "3001:3000"
    environment:
      - DATABASE_URL=postgresql://typebot:TypebotPass123@typebot-db:5432/typebot
      - NEXTAUTH_URL=https://bot.yourdomain.com
      - NEXT_PUBLIC_VIEWER_URL=https://chat.yourdomain.com

  typebot-db:
    image: postgres:16-alpine
    container_name: typebot-db
    restart: unless-stopped
    volumes:
      - typebot_db:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=typebot
      - POSTGRES_USER=typebot
      - POSTGRES_PASSWORD=TypebotPass123

volumes:
  typebot_db:

Launch and Build

docker compose up -d

Access the builder at http://your-breeze-ip:3000. Create a new typebot, add conversation blocks including text bubbles, input fields, conditions, and integrations. Publish and share the chat link or embed it on your website.

Integration Options

• Webhook blocks for sending data to any API endpoint
• Google Sheets integration for saving responses
• OpenAI blocks for AI-powered conversational flows
• Embed as a popup, bubble, or full-page chat on any website