Repolode
Submit
javahuang

javahuang/SurveyKing

Self-hosted platform for surveys, graded exams, and question-bank practice, with AI-assisted form creation and response analytics.

Open-source alternative to:SurveyMonkeyGoogle Forms

View on GitHubWebsite
Stars
4,033
Forks
607
Open issues
62
Last commit
2 months ago

What is it?

SurveyKing is a self-hosted system for building surveys, exams, and question-bank practice in one place. Teams can deploy it on their own infrastructure with Docker, starting with the embedded H2 database and moving to MySQL for production use.

On the survey side, it offers 20+ question types, conditional logic, themes, publishing controls such as passwords, allowlists and response limits, and live reports. Exams reuse question banks, support answer keys, scoring rules, randomization, automatic grading and rankings. The practice module lets learners work through questions sequentially, randomly, or from their incorrect answers, with explanations, favorites and notes.

Forms and exams can be drafted from natural language through streaming AI output that shows a live preview, using OpenAI-compatible APIs. The interface is available in eight languages, and login supports Google OAuth and WeChat options.

Key features

  • 01Surveys with 20+ question types, conditional logic and branching
  • 02Exams with question banks, automatic grading and rankings
  • 03Question-bank practice in sequential, random and incorrect-answer modes
  • 04AI-assisted creation through OpenAI-compatible APIs with live preview
  • 05Publishing controls including passwords, allowlists, schedules and response limits
  • 06Google OAuth and WeChat login, with RBAC user management

Use cases

  • Collecting customer or employee feedback on infrastructure you control
  • Running online exams with automatic scoring for training or certification
  • Giving learners a question bank for self-directed practice and review
  • Replacing a hosted survey service where data must stay in-house

Quick start

  1. 1

    Start SurveyKing with Docker and the built-in H2 database

    docker run -d --name surveyking -p 1991:1991 surveyking/surveyking:latest
  2. 2

    Open http://localhost:1991 and sign in with the default admin account, then change the password

Things to know

  • The default admin password is well known, so it must be changed right after the first start.

In collections

Self-hosted apps

Topics

#survey#exam#self-hosted#question-bank#form-builder#spring-boot#react#docker#java#react-survey

FAQ

What is SurveyKing?
Self-hosted platform for surveys, graded exams, and question-bank practice, with AI-assisted form creation and response analytics. SurveyKing is a self-hosted system for building surveys, exams, and question-bank practice in one place. Teams can deploy it on their own infrastructure with Docker, starting with the embedded H2 database and moving to MySQL for production use.
Is SurveyKing free to use? What license does it have?
SurveyKing is open source under the MIT license. Check the license terms before using it in commercial products.
Is SurveyKing still maintained?
Updated within 6 months. The last commit to SurveyKing was on Aug 26, 2026.
What can I use SurveyKing for?
Collecting customer or employee feedback on infrastructure you control Running online exams with automatic scoring for training or certification Giving learners a question bank for self-directed practice and review Replacing a hosted survey service where data must stay in-house
How do I install SurveyKing?
Start SurveyKing with Docker and the built-in H2 database: docker run -d --name surveyking -p 1991:1991 surveyking/surveyking:latest Open http://localhost:1991 and sign in with the default admin account, then change the password
Where can I get SurveyKing?
The source code and installation instructions are on GitHub: https://github.com/javahuang/SurveyKing

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects