Guide
Self-hosted Secret Santa
KovertKlaus is free to run on your own computer or server. Your names, addresses and wishlists stay on a machine you control.
Who it’s for
- Families or friend groups with someone who runs a home server.
- Companies, schools and clubs that keep people’s data in-house.
- Anyone who likes to tinker.
What you need
- A computer or server with Docker.
- Git and Node.js 24 or later.
- About ten minutes.
Quick start
git clone https://github.com/MrJSimpson/KovertKlaus.git
cd KovertKlaus
npm run db:password
docker compose up -dThen open http://localhost:2425. The first time it starts, the server prints a one-time setup code (docker logs kovertklaus-app). Use it at /northpole/setup to create your administrator account.
Good to know
- Email is optional. Without an email service, new accounts skip email verification, and people join with the mission code you share.
- Want to try it first?
npm run demo:loadadds demo agents and missions, andnpm run demo:removetakes them out again. - Backups, updates and email setup are covered in the README.
License
You can run, change and self-host KovertKlaus free of charge: for yourself, your family and friends, or your own company, school, club or non-profit. Selling it to others as a hosted service is reserved to its author. Read the license.