Skip to content
KovertKlaus
← All guides

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 -d

Then 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:load adds demo agents and missions, and npm run demo:remove takes 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.

Ready when you are.

Free, private, and set up in a couple of minutes.

Prefer not to host it? Start a mission here