HeyForm

An open-source conversational form builder for surveys, quizzes, and polls.

Accessing Your HeyForm Instance

  • Open your browser and visit: http://<Server_IP>
  • Create your first account using the registration page.

Managing Registration (Security Important)

Registration is enabled by default.

To disable new user sign-ups:

  1. Edit the .env file: APP_DISABLE_REGISTRATION=true
  2. Apply changes: docker compose -f /root/heyform/docker-compose.yml up -d

This prevents unauthorized users from creating accounts.

Important Files and Directories

  • Application directory: /root/heyform
  • Docker environment file: /root/heyform/.env
  • Docker Compose file: /root/heyform/docker-compose.yml
  • Uploaded form images: /root/heyform/assets/
  • MongoDB data volume: mongodb_data stored under /var/lib/docker/volumes/
  • KeyDB data volume: keydb stored under /var/lib/docker/volumes/
  • Nginx reverse proxy config: /etc/nginx/sites-available/heyform.conf

Domain & SSL Setup

Point your domain to the server IP.

Edit Nginx config:

vim /etc/nginx/sites-available/heyform.conf

Replace server_name <IP>; with server_name <your-domain>;

Install Certbot:

apt install -y certbot python3-certbot-nginx

Run Certbot to issue SSL certificate:

certbot --nginx --non-interactive --agree-tos --email <your-email> -d <your-domain>

Test and reload Nginx:

sudo nginx -t
sudo systemctl reload nginx

Open in browser: https://<your-domain>

Application Details