Alpine :: KMS

Run a KMS server based on Alpine Linux. Small, lightweight, secure and fast 🏔️

Works with:

• Windows Vista
• Windows 7
• Windows 8
• Windows 8.1
• Windows 10 ( 1511 / 1607 / 1703 / 1709 / 1803 / 1809 )
• Windows 10 ( 1903 / 1909 / 20H1, 20H2, 21H1, 21H2 )
• Windows 11 ( 21H2 )
• Windows Server 2008
• Windows Server 2008 R2
• Windows Server 2012
• Windows Server 2012 R2
• Windows Server 2016
• Windows Server 2019
• Windows Server 2022
• Microsoft Office 2010 ( Volume License )
• Microsoft Office 2013 ( Volume License )
• Microsoft Office 2016 ( Volume License )
• Microsoft Office 2019 ( Volume License )
• Microsoft Office 2021 ( Volume License )

Volumes

• /kms/var - Directory of the sqlite database

Run

docker run --name kms \
  -v ../var:/kms/var \
  -d 11notes/kms:[tag]

Defaults

Parameter	Value	Description
user	docker	user docker
uid	1000	user id 1000
gid	1000	group id 1000
home	/kms	home directory of user docker

Environment

Parameter	Value	Default
KMS_IP	localhost or 127.0.0.1 or a dedicated IP	0.0.0.0
KMS_PORT	any port > 1024	1688
KMS_LOCALE	see Microsoft LICD specification	1033 (en-US)
KMS_CLIENTCOUNT	client count >= 25	256
KMS_ACTIVATIONINTERVAL	Retry unsuccessful after N minutes	120 (2 hours)
KMS_RENEWALINTERVAL	re-activation after N minutes	259200 (180 days)
KMS_LOGLEVEL	CRITICAL, ERROR, WARNING, INFO, DEBUG, MININFO	INFO

Parent

• python:3.7.10-alpine

Built with

• py-kms
• Alpine Linux

Tips

• Don't bind to ports < 1024 (requires root), use NAT/reverse proxy
• Persistent Storage
• Microsoft LICD