📋FormSG

This guide helps you deploy and maintain FormSG in your own infrastructure.

Welcome to the FormSG Self-Hosting Guide

Self-host FormSG to:

• Maintain complete data sovereignty within your jurisdiction

• Meet compliance requirements specific to your regulatory environment

• Integrate seamlessly with existing government systems and identity providers

• Reduce vendor lock-in while keeping full operational control

This guide takes you from evaluation to production deployment, with paths tailored for decision makers, developers, and IT teams.

🎯 Quick Start: See FormSG in Action

Try the Live Demo (5 minutes)

Experience FormSG's capabilities firsthand before deploying:

1. Visit: form.demos.sg

2. Sign in: Use any Gmail, Yahoo, Hotmail or Outlook email

3. Explore: Create a form, test conditional logic, try file uploads

4. Share: Generate a link to demonstrate functionality to your team

Demo environment: Forms expire after 3 hours. Payment and webhook features are disabled. This environment is designed for evaluation and proof-of-concept demonstrations.

📚 Additional Resources

• This GitBook - Complete, currently developed, self-hosting guide

• GitHub Repository - Source code, issues, discussions

🚀 What is FormSG?

FormSG is a self-service, easy-to-use and feature-rich form builder that enables public officers to collect citizen data quickly and securely.

Proven at Scale

• 200+ million paper form submissions replaced

• 160+ public agencies actively using FormSG

• 150,000+ public officers as active users

• Since 2017 - Battle-tested in production for over 7 years

FormSG handles everything from simple contact forms to complex multi-step applications with conditional logic, file uploads, and payment processing.

This is the self-hosting deployment guide. For guides on creating, managing, and using forms, visit the user guide: https://guide.form.gov.sg/

⚓ Choose Your Starting Point

This guide assumes your team has experience with:

• Basic Linux server administration

• Docker or container orchestration

• Managing environment variables and secrets

• Working with Node.js applications

While technical knowledge is helpful, don't let it stop you from getting started!

🎯 Decision Maker

"Should my organisation adopt FormSG?"

✏️Evaluation Guide

Cost-benefit analysis, risk assessment, and technical feasibility frameworks for go/no-go decisions.

📖 15 min read

👨‍💻 Developer

"I want to try FormSG locally first"

⚡Quickstart

Get a local development environment running in 30 minutes to test FormSG's capabilities and understand the architecture hands-on.

📖 10 min read + 30 min setup

🏗️ Mature Team

"We want to deploy to production"

🚀Deployment

Complete AWS deployment with security, monitoring, and validation.

📖 45 min read

☁️ Alternative Cloud

"AWS may not be for us"

🗼Infrastructure Guidance

Deploy to non-AWS cloud providers or on-premises infrastructure.

📖 20 min read

🔧 Platform Engineering Team

"We need to integrate with existing systems"

🧩Component Customization

Replace email, storage, identity providers, and other components with your organisation's alternatives.

📖 25 min read

⚖️ Compliance Officer

"What are our legal obligations?"

⚖️Legal and Compliance

Legal and compliance requirements you must follow when forking FormSG.

📖 10 min read