🏔️ kms on Alpine

Activate any version of Windows and Office, forever

SYNOPSIS 📖

What can I do with this? This image will run a KMS server you can use to activate any version of Windows and Office, forever. If you need a GUI, simply add 11notes/kms-gui to your compose.

Works with:

Windows Vista
Windows 7
Windows 8
Windows 8.1
Windows 10
Windows 11
Windows Server 2008
Windows Server 2008 R2
Windows Server 2012
Windows Server 2012 R2
Windows Server 2016
Windows Server 2019
Windows Server 2022
Windows Server 2025
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 )
Microsoft Office 2024 ( Volume License )

VOLUMES 📁

/kms/var - Directory of the activation database

COMPOSE ✂️

name: "kms"
services:
  kms:
    image: "11notes/kms:646f476"
    container_name: "kms"
    environment:
      TZ: "Europe/Zurich"
    volumes:
      - "var:/kms/var"
    ports:
      - "1688:1688/tcp"
    restart: "always"
  kms-gui:
    image: "11notes/kms-gui:latest"
    container_name: "kms-gui"
    environment:
      TZ: "Europe/Zurich"
    volumes:
      - "var:/kms/var"
    ports:
      - "8080:8080/tcp"
    restart: "always"
volumes:
  var:

Windows Server 2025 Datacenter. List of GVLK

slmgr /ipk D764K-2NDRG-47T6Q-P8T8W-YP6DF

Add your KMS server information to server

Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\SoftwareProtectionPlatform" -Name "KeyManagementServiceName" -Value "KMS_IP"
Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\SoftwareProtectionPlatform" -Name "KeyManagementServicePort" -Value "KMS_PORT"
Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\OfficeSoftwareProtectionPlatform" -Name "KeyManagementServiceName" -Value "KMS_IP"
Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\OfficeSoftwareProtectionPlatform" -Name "KeyManagementServicePort" -Value "KMS_PORT"

Activate server

slmgr /ato

DEFAULT SETTINGS 🗃️

Parameter	Value	Description
`user`	docker	user name
`uid`	1000	user identifier
`gid`	1000	group identifier
`home`	/kms	home directory of user docker
`database`	/kms/var/kms.db	SQlite database holding all client data

ENVIRONMENT 📝

Parameter	Value	Default
`TZ`	Time Zone
`DEBUG`	Will activate debug option for container image and app (if available)
`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_ENHANCED_PRIVACY_ID`	set custom ePID (will overwrite KMS_LOCALE)
`KMS_CLIENTCOUNT`	client count > 25	26
`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

SOURCE 💾

11notes/kms

PARENT IMAGE 🏛️

11notes/alpine:stable

BUILT WITH 🧰

GENERAL TIPS 📌

Use a reverse proxy like Traefik, Nginx, HAproxy to terminate TLS and to protect your endpoints
Use Let’s Encrypt DNS-01 challenge to obtain valid SSL certificates for your services
Do not expose this image to WAN! You will get notified from Microsoft via your ISP to terminate the service if you do so
Microsoft LICD

ElevenNotes™️

This image is provided to you at your own risk. Always make backups before updating an image to a different version. Check the releases for breaking changes. If you have any problems with using this image simply raise an issue, thanks. You can find all my repositories on github.

5.3 KiB Raw Blame History Unescape Escape