Skip to main content

Install KMS on docker compose

Deploying pyKMS Using Docker-compose

Firstly, it’s worth mentioning that while pyKMS can activate any license without question, it’s not intended for use with unlicensed copies of Windows. Your organization should legally own the licenses for all Windows instances that you intend to activate with pyKMS.

Prerequisites

To deploy pyKMS using Docker-compose, you need:

  1. Docker installed on your machine.
  2. Docker-compose installed on your machine.

Steps to Deploy

  • Create a directory for your docker-compose.yml file: mkdir py-kms
  • Navigate to the new directory: cd py-kms
  • Open your text editor and create a docker-compose.yml file. This file defines your services, networks, and volumes. Populate it as follows:
version: '3'
services:
  kms:
    image: ghcr.io/py-kms-organization/py-kms:python3
    ports:
      - 1688:1688
      - 8080:8080
    environment:
      IP: "::"
      HWID: RANDOM
      LOGLEVEL: INFO
      NTP_SERVERS: 0.fr.pool.ntp.org
      TZ: Europe/Paris
    restart: always
    volumes:
      - ./db:/home/py-kms/db
      - /etc/localtime:/etc/localtime:ro
  • Save the docker-compose.yml file and exit your text editor.
  • Execute the Docker-compose command: docker-compose up -d

You’ve now deployed your pyKMS server using Docker-compose! The server will auto-start every time your machine boots, thanks to the restart: always command.