Skip to content


Original README from the py-kms github:


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.


  • Responds to V4, V5, and V6 KMS requests.
  • Supports activating:
    • Windows Vista
    • Windows 7
    • Windows 8
    • Windows 8.1
    • Windows 10 ( 1511 / 1607 / 1703 / 1709 / 1803 / 1809 / 1903 / 1909 )
    • Windows Server 2008
    • Windows Server 2008 R2
    • Windows Server 2012
    • Windows Server 2012 R2
    • Windows Server 2016
    • Windows Server 2019
    • Microsoft Office 2010 ( Volume License )
    • Microsoft Office 2013 ( Volume License )
    • Microsoft Office 2016 ( Volume License )
    • Microsoft Office 2019 ( Volume License )
  • It's written in Python:
    • tested with Python 2.7.15rc1
    • tested with Python 3.6.7


  • Python 3.x or Python 2.7.x or Python 2.6.x with the argparse module installed.
  • Tkinter module.
  • If the tzlocal module is installed, the "Request Time" in the verbose output will be converted into local time. Otherwise, it will be in UTC.
  • It can use the sqlite3 module so you can use the database function, storing activation data so it can be recalled again.
  • Installation example on Ubuntu / Mint:
    • sudo apt-get update
    • for python3
    • sudo apt-get install python3-tk python3-pip
    • sudo pip3 install tzlocal pysqlite3
    • or for python2
    • sudo apt-get install python-tk python-pip
    • sudo pip install tzlocal pysqlite


  • NOTE: Pay attention to how invoke scripts, if you want to run with python2 use python... while for python3 use python3..., also depending on the Python versions that resides in your PC.
  • To start the server, execute python [IPADDRESS] [PORT], the default IPADDRESS is "" ( all interfaces ) and the default PORT is "1688".
  • To run the client (only for testing purposes), use python [IPADDRESS] [PORT], with the same defaults of
  • To show the help pages type: python -h and python -h.
  • To generate a random HWID use -w option: python -w RANDOM.
  • To get the HWID from any server use the client, for example type: python 1688 -m Windows8.1 -V INFO.
  • To view a minimal set of logging information use -V MINI option, for example: python -F /path/to/your/logfile.log -V MINI.
  • To redirect logging on stdout use -F STDOUT option, for example: python -F STDOUT -V DEBUG.
  • You can create logfile and view logging information on stdout at the same time with -F FILESTDOUT option, for example: python -F FILESTDOUT /path/to/your/logfile.log -V DEBUG.
  • Select timeout (seconds) for py-kms with -t option, for example python -t 10
  • For launching py-kms GUI make executable file with chmod +x /path/to/folder/py-kms/, then simply run double-clicking.
  • You can run py-kms deamonized (via Etrigan) using a command like: python etrigan start and stop it with: python etrigan stop.
  • With Etrigan you have another way to launch py-kms GUI (specially suitable if you're using a virtualenv), so: python etrigan start -g and stop the GUI with the same precedent command (or interact with EXIT button).


auto-docker status-docker

This projects has docker image support. You can find all available image configurations inside the docker folder. There are three tags of the images available: * latest, currently the same like minimal... * minimal, wich is based on the python3 minimal configuration of py-kms. This image does NOT include SQLLite support! * python2, which is fully configurable and equiped with SQLLite support and web interface. * python3, which is like the python2 tag - just with Python 3... If you just want to use the image and don't want to build them yourself, you can use the official image at the docker hub (pykmsorg/py-kms). To ensure that the image is always up-to-date you should check watchtower out!

Other Important Stuff

Consult the Wiki for more information about activation with py-kms and to get GVLK keys.