Py-KMS-Organization/py-kms
1
0
Fork 0
mirror of https://github.com/Py-KMS-Organization/py-kms.git synced 2026-01-20 15:20:14 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity
KMS Server Emulator written in Python
473 commits 4 branches 0 tags 4.3 MiB
Python 96.6%
HTML 1.9%
Dockerfile 1%
Smarty 0.5%
Find a file
simonmicro 351edba477
Some checks failed
Build next tags / bake-next (push) Has been cancelled
Details
Test-Build Docker Image / bake-test (push) Has been cancelled
Details
Merge pull request #140 from Py-KMS-Organization/feature/semantic_version 
Semantic version
2026-01-18 20:59:49 +01:00
.github/workflows Update workflows to also build tagged releases 2025-12-06 19:00:32 +01:00
charts/py-kms Added new endpoints 2023-03-15 23:00:06 +01:00
docker Update workflows to also build tagged releases 2025-12-06 19:00:32 +01:00
docs Dropped changelog symlink 2025-12-06 19:48:54 +01:00
py-kms Use correct non-branch wording 2025-12-06 19:00:32 +01:00
.dockerignore add healthcheck with netcap checking port 2021-10-26 22:56:47 +02:00
.gitignore Removed Etrigan support 2023-02-21 14:08:41 +01:00
.readthedocs.yaml Fix RTD 2025-11-08 13:15:23 +01:00
LICENSE Create LICENSE 2017-06-14 23:57:16 +02:00
README.md Typo 2025-12-06 19:02:35 +01:00
requirements.txt Removed docs dependencies from requirements.txt 2023-02-21 14:08:42 +01:00

README.md

py-kms

repo-size open-issues last-commit docker-pulls read-the-docs

Keep in mind that this project is not intended for production use. Feel free to use it to test your own systems or maybe even learn something from the protocol structure. 😉

History

py-kms is a port of node-kms created by cyrozap, which is a port of either the C#, C++, or .NET implementations of KMS Emulator. The original version was written by CODYQX4 and is derived from the reverse-engineered code of Microsoft's official KMS. This version of py-kms is for itself a fork of the original implementation by SystemRage, which was abandoned early 2021.

What is with version 1.0.0?

Semantic versioning is now being used in this project, so checkout the GitHub Releases. Before, a CHANGELOG.md file was used to track changes, but got abandoned over time. Its content got moved into the Historic Releases document for reference.

Features

  • Responds to v4, v5, and v6 KMS requests.
  • Supports activating a lot of products, so checkout the docs for more information.
    • It's written in Python.
    • Supports execution by Docker, systemd and many more...
    • Uses sqlite for persistent data storage (with a simple web-based explorer).

Documentation

The wiki has been completely reworked and is now available on readthedocs.io. It should provide you all the necessary information about how to setup and to use py-kms, all without clumping this readme. The documentation also houses more details about the activation procedure with py-kms and how to get GVLK keys.

Quick start

  • To start the server, execute python3 pykms_Server.py [IPADDRESS] [PORT], the default IPADDRESS is :: ( all interfaces ) and the default PORT is 1688.
    • Note that both the address and port are optional.
    • It's allowed to use IPv4 and IPv6 addresses.
    • If you have an IPv6-capable dual-stack OS, a dual-stack socket is created when using a IPv6 address.
    • In case your OS does not support IPv6, make sure to explicitly specify the legacy IPv4 of 0.0.0.0!
  • To start the server automatically using Docker, execute docker run -d --name py-kms --restart always -p 1688:1688 ghcr.io/py-kms-organization/py-kms.
  • To show the help pages type: python3 pykms_Server.py -h and python3 pykms_Client.py -h.

License

  • py-kms is Unlicense