HeyForm

Development1024MB+ RAM

Open-source form builder — conversational forms, surveys, and quizzes with logic jumps, file uploads, and integrations

Download Server Compass Install HeyForm to VPS

developmentdevtoolsheyformopen-sourceself-hosteddocker

Deploy HeyForm in 3 Steps

Connect Your VPS

Add your server credentials to Server Compass

Select HeyForm

Choose from our template library

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required

Step-by-step deployment guide

Deploy HeyForm on a VPS with Server Compass

Use the HeyForm template in Server Compass to deploy a self-hosted form builder on your VPS, then verify the first account screen.

About 10 minutesBrowser verified

Step 1

Open the server Apps tab

Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating a HeyForm app

Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template

Step 3

Search for HeyForm

Use the template picker search to find HeyForm in the Server Compass template catalog.

Searching for HeyForm in the Server Compass template picker

Step 4

Select the HeyForm template

Choose the HeyForm template. Server Compass fills the HeyForm service, MongoDB and Redis dependencies, session secret, homepage URL, and public web port.

HeyForm template selected in Server Compass

Step 5

Review the HeyForm settings

Confirm the app name and compose service. In this run, the app was named heyform-demo and used host port 4131.

Reviewing HeyForm project settings and compose service

Step 6

Deploy HeyForm

Review the generated compose settings, confirm the HeyForm web port is available, and click Deploy.

Reviewing HeyForm web port before deployment

Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the HeyForm image, starts the container, and verifies the stack.

Server Compass deploying the HeyForm template on the VPS

Step 8

Confirm HeyForm is running

After deployment finishes, return to the Apps tab and confirm the HeyForm app is marked Running with its application URL available.

HeyForm template running in the Server Compass Apps tab

Step 9

Open HeyForm in the browser

Open the application URL in a browser. The HeyForm account screen confirms the form builder is reachable and ready for first-run setup.

The deployed HeyForm web UI loaded in a browser

After HeyForm Opens

Register the first admin account immediately after deployment.
Put HeyForm behind HTTPS before collecting real form submissions.
Back up the MongoDB volume because it stores forms, users, and submissions.
Configure SMTP before relying on email notifications or password resets.
Keep the HeyForm image updated for Node.js and application security fixes.

Verified Result

The HeyForm account screen loaded successfully from the deployed container.

Download Server Compass Docs

HeyForm deployment questions

What does the HeyForm template deploy?

It deploys the HeyForm Community Edition image with MongoDB and Redis service containers.

Which port did the tutorial use?

The tutorial used host port 4131, which maps to the HeyForm web UI on container port 9513.

Does HeyForm need setup after deployment?

Yes. Visit the app URL, create the first admin account, configure SMTP if needed, then build and publish your first form.

Should this become a blog post?

No. The deployment guide should live on the HeyForm template detail page and be linked from the reusable template deployment docs page.

After Deployment

After deploying HeyForm with Server Compass, complete these steps to finish setup

Visit the application URL and register the initial admin account

Configure SMTP under settings for email notifications and password resets

Build your first form with the drag-and-drop editor and publish it

Share the form link or embed it on your site

Need help? Check out our documentation for detailed guides.

HeyForm FAQ

Common questions about self-hosting HeyForm

How do I deploy HeyForm with Server Compass?

Simply download Server Compass, connect to your VPS, and select HeyForm from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for HeyForm?

HeyForm requires a minimum of 1024MB RAM. We recommend a VPS with at least 2048MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing HeyForm data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard HeyForm backup and restore procedures.

How do I update HeyForm to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest HeyForm image will be pulled and deployed with zero downtime.

Is HeyForm free to self-host?

HeyForm is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Related Templates

View all Development

PocketBase

Open-source backend in a single file with realtime database, auth, and file storage

Appwrite

Open-source backend-as-a-service - self-hosted Firebase alternative

Parse Server

Open-source backend framework with dashboard

Supabase

Full Supabase self-hosted with Kong, GoTrue Auth, Realtime, and Studio

Ready to Self-Host HeyForm?

Download Server Compass and deploy HeyForm to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass