# One‑command Docker deploy (embedded H2)
docker run -d -p 1991:1991 surveyking/surveyking

Website · Deploy Docs · User Guide · Live Demo · AI Docs

English | 简体中文

SurveyKing is an AI‑powered, enterprise‑grade survey and online exam system. Create professional surveys from natural language, run exams with item banks and auto‑grading, and publish across web and mobile — all open source.

One command to deploy a more powerful, self‑hosted alternative to SurveyMonkey — with built‑in exams, item bank, and AI generation.

• AI survey generation from natural language prompts; supports multiple mainstream models
• 20+ question types: text, choice, dropdown, matrix, cascader, file upload, signature, pagination, question groups, and more
• Powerful logic engine: show/hide logic, required rules, skip/branching, calculations, randomization
• Survey and exam modes: item bank, question picker, randomized papers, automatic grading, import/export
• Real‑time analytics and exportable reports (CSV/Excel)
• Collaboration and roles: multi‑user management, role‑based permissions
• Responsive across devices: desktop, mobile, and WeChat Mini Program
• One‑click deploy via Docker; supports external MySQL or embedded H2
• Multi‑language (i18n): English and Simplified Chinese today; more languages coming

1. Run the Docker image (embedded H2 database):

docker run -d -p 1991:1991 surveyking/surveyking

2. Open http://localhost:1991 and sign in:

• Username: admin
• Password: 123456

That’s it. You’re ready to create your first survey or exam.

Use the Alibaba Cloud mirror if the default registry is slow:

docker run -d -p 1991:1991 registry.cn-hangzhou.aliyuncs.com/surveyking/surveyking:latest

Persist files and logs on the host:

docker run -d \
  -p 1991:1991 \
  -v ${PWD}/files:/app/files \
  -v ${PWD}/logs:/app/logs \
  surveyking/surveyking

Connect to an external MySQL (auto‑migrates schema on first run):

docker run -d \
  -p 1991:1991 \
  -e PROFILE=mysql \
  -e MYSQL_USER=surveyking \
  -e MYSQL_PASS=surveyking \
  -e DB_URL='jdbc:mysql://172.17.0.1:3306/surveyking?rewriteBatchedStatements=true&useUnicode=true&characterEncoding=UTF-8' \
  -v ${PWD}/files:/app/files \
  -v ${PWD}/logs:/app/logs \
  surveyking/surveyking

More screenshots in the docs folder.

• Current languages: English, Simplified Chinese
• More languages are on the way; community contributions are welcome

• Website: https://surveyking.cn/
• Deploy Docs: https://surveyking.cn/open-source/deploy.html
• User Guide: https://surveyking.cn/help/quickstart.html
• AI Docs: https://surveyking.cn/open-source/docs/ai
• Live Demo (Survey/Exam): https://s.surveyking.cn/

Issues and pull requests are welcome. If you like SurveyKing, please give us a star — it really helps.

MIT License © SurveyKing contributors