Try describing what you need:

HeyForm logo

HeyForm

★ 9.0k

A self-hosted alternative to Typeform, Google Forms, Surveymonkey

GNU Affero General Public License v3.0Open Source — No Paywall3 Containers — 3 containers — light hosting footprintDocker · SourceNo external DB10 active committers (12mo)

About

HeyForm is an open-source form builder aimed at small businesses and teams that need to collect information or feedback through conversational forms. It supports the creation of surveys, quizzes, and...

Community Ratings

No ratings yet
HeyForm

Features

  • Conversational forms
  • Surveys, quizzes, and polls
  • Conditional logic
  • URL redirections
  • Webhooks and integrations
  • Analytics
  • CSV export
  • Custom branding and themes
  • Custom CSS
  • File uploads

Details

Last Updated
Oct 23, 2026
Created
Mar 20, 2024
Install Methods
dockersource
Requirements
OpenID Connect identity provider for self-hosted SSO setup (e.g. Authelia, Authentik, Keycloak)
Authentication
oidc-sso
Backup & Export
database-dump
Runtime / Stack
Docker
Privacy & Independence
Cloud: Optional
Deployment

Deployment: Docker Compose ✓3 Containers — light hosting footprintRuns as 3 containers

Run HeyForm with Docker Compose

Compose file from the HeyForm project repository.

3 services · infra: keydb · 1 unclassified (percona-server-mongodb)

no resource limits declared

needs persistent storage (4 volumes)

docker-compose.test.yml · @ 92aa9f4 · scanned Sep 25, 2026

version: '3.9'

networks:
  heyform-mongo:
  heyform-keydb:

services:
  heyform:
    image: heyform-local:test
    build:
      context: .
      dockerfile: Dockerfile
    restart: unless-stopped
    depends_on:
      - mongo
      - keydb
    ports:
      - '9157:9157'
    healthcheck:
      test: ["CMD-SHELL", "wget -qO- http://127.0.0.1:9157/health/ready >/dev/null || exit 1"]
      interval: 15s
      timeout: 3s
      retries: 5
      start_period: 30s
    env_file:
      - .env
    environment:
      APP_HOMEPAGE_URL: ${APP_HOMEPAGE_URL:-http://localhost:9157}
      SESSION_KEY: ${SESSION_KEY:?SESSION_KEY is required}
      FORM_ENCRYPTION_KEY: ${FORM_ENCRYPTION_KEY:?FORM_ENCRYPTION_KEY is required}
      MONGO_URI: mongodb://mongo:27017/heyform
      REDIS_HOST: keydb
      REDIS_PORT: 6379
      SMTP_FROM: ${SMTP_FROM}
      SMTP_HOST: ${SMTP_HOST}
      SMTP_PORT: ${SMTP_PORT}
      SMTP_USER: ${SMTP_USER}
      SMTP_PASSWORD: ${SMTP_PASSWORD}
      SMTP_SECURE: ${SMTP_SECURE:-false}
      SMTP_SERVERNAME: ${SMTP_SERVERNAME:-}
      SMTP_IGNORE_CERT: ${SMTP_IGNORE_CERT:-false}
    volumes:
      # Keep uploads between restarts (covers both current static path and runtime-served path)
      - ./assets:/app/packages/server/static/upload
      - ./assets:/app/packages/server/uploads
    networks:
      - heyform-mongo
      - heyform-keydb

  mongo:
    image: percona/percona-server-mongodb:4.4
    restart: unless-stopped
    ports:
      - '27017:27017'
    volumes:
      - mongodb_data:/data/db
    networks:
      - heyform-mongo

  keydb:
    image: eqalpha/keydb:latest
    restart: unless-stopped
    ports:
      - '9514:6379'
    command: keydb-server --appendonly yes --protected-mode no
    volumes:
      - keydb_data:/data
    networks:
      - heyform-keydb

volumes:
  mongodb_data:
  keydb_data:

This file may be out of date. Check the HeyForm documentation for current setup steps.

Track your self-hosted stack

Bookmark software to try, rate tools you've used, and keep your collection in one place.

Metadata extracted from README on Oct 13, 2026

Related Software

Formbricks logo

Formbricks

13.1k
Formbricks is an open source survey and experience management platform for collecting feedback through in-app, website, link, and email surveys.
Polls and EventsCopyleft LicenseAnalytics Tools+4
Open CoreFOSS with Issues
Details
OpnForm logo

OpnForm

3.9k
OpnForm is an open-source form builder for creating, embedding, and managing forms with no-code tools.
Polls and EventsWebsite BuildersAutomation Tools+3
Open Core
Details
LimeSurvey logo

LimeSurvey

3.8k
An open-source online survey platform for creating, sharing, and analyzing surveys.
Polls and EventsSelf Hosting SolutionsAnalytics Tools+1
Details
docassemble logo

docassemble

992
docassemble is a platform for guided document assembly and interview-based automation.
Polls and EventsAutomation ToolsDocument Management+3
Details
Mautic logo

Mautic

10.8k
Open source marketing automation software for creating and managing integrated marketing campaigns.
Mailing ListsSelf Hosting SolutionsAutomation Tools+3
Details
Typebot logo

Typebot

10.6k
Typebot is a visual chatbot builder for creating advanced chatbots, embedding them in web or mobile apps, and collecting results in real time.
Custom CommunicationsWebsite BuildersLow Code Development+4
Details
TeslaMate logo

TeslaMate

9.2k
TeslaMate is a self-hosted data logger for Tesla vehicles with dashboards, analysis, and home automation integrations.
Miscellaneous ToolsSelf Hosting SolutionsPersonal Dashboards+5
Details
Speedtest Tracker logo

Speedtest Tracker

6.0k
A self-hosted application that monitors the performance and uptime of an internet connection.
Network UtilitiesSelf Hosting SolutionsStatus Pages+4
Details
OpenRemote logo

OpenRemote

1.9k
An open-source IoT platform for device management, automation, data analytics, and multi-tenant management.
IoT PlatformsAutomation ToolsAnalytics Tools+3
Details
phpList logo

phpList

878
phpList is an open source email marketing manager for creating, sending, integrating, and analysing email campaigns and newsletters.
Mailing ListsSelf Hosting SolutionsAnalytics Tools+3
6 ContainersFully FOSS
Details
Lago logo

Lago

10.7k
Lago is an open-source monetization and billing platform for usage-based pricing, invoices, credits, entitlements, and payments.
Budgeting and FinanceAnalytics ToolsCopyleft License+2
8 ContainersOpen Core
Details
Plunk logo

Plunk

5.5k
Plunk is an open-source email platform for sending transactional emails, campaigns, and automations from self-hosted applications.
Email SolutionsMailing ListsAutomation Tools+2
Cloud Required
Details