GNet Solutions » GNU/Linux Administration

This is a guide on installing py-kms on Debian.

Prepare the Environment¶

• Make sure everything is up to date:
  

  sudo apt update && sudo apt upgrade
  sudo apt install git python3.11-venv
  

• Create the nextcloud user:
  

  sudo groupadd py-kms
  sudo useradd -M -g py-kms -s /usr/sbin/nologin -c "py-kms" py-kms
  

Install py-kms¶

• Download py-kms:
  

  cd /opt
  sudo git clone https://github.com/Py-KMS-Organization/py-kms.git
  sudo touch py-kms/pykms_logserver.log
  sudo chown -R py-kms:py-kms py-kms
  

• Install py-kms venv:
  

  sudo -u py-kms sh -c "/usr/bin/python3 -m venv /opt/py-kms/.env" 
  sudo su -s/bin/bash py-kms
  source .env/bin/activate
  pip install -r requirements.txt
  exit
  

• Create the systemd unit file:
  

  sudo nano /etc/systemd/system/py3-kms.service
  

  • Add the following:
    

    [Unit]
    Description=py3-kms
    After=network.target
    StartLimitIntervalSec=0
    
    [Service]
    Type=simple
    Restart=always
    RestartSec=1
    KillMode=process
    User=py-kms
    ExecStart=/opt/py-kms/.env/bin/python3 /opt/py-kms/py-kms/pykms_Server.py 192.168.0.100 1688 -V DEBUG -F /opt/py-kms/pykms_logserver.log
    
    [Install]
    WantedBy=multi-user.target
    

• Set the unit file permissions and check its integrity:
  

  sudo chmod 644 /etc/systemd/system/py3-kms.service
  sudo systemd-analyze verify py3-kms.service
  

• Reload systemd and start the service:
  

  sudo systemctl daemon-reload
  sudo systemctl start py3-kms.service
  

Windows Activation¶

• Open a cmd prompt as Administrator and uninstall product key (optional):
  

  cscript //nologo slmgr.vbs /upk
  

• Install new product key (optional):
  

  cscript //nologo slmgr.vbs /ipk 12345-abdce-67890-fghij-12345
  

• Set KMS to py-kms IP address:
  

  cscript //nologo slmgr.vbs /skms 192.168.0.100:1688
  

• Run activation:
  

  cscript //nologo slmgr.vbs /ato
  

Office Activation¶

• Open a cmd prompt as Administrator and change directory to the Office install path:
  

  cd C:\ProgramFiles(x86)\Microsoft Office\Office14
  

  
  NOTE: 14 for Office 2010, 15 for Office 2013, 16 for Office 2016 or Office 2019

• Set host to py-kms instance:
  

  cscript //nologo ospp.vbs /sethst:192.168.0.100
  

• Set port to py-kms port:
  

  cscript //nologo ospp.vbs /setprt:1688
  

• Run activation
  

  cscript //nologo ospp.vbs /act
  

Resources¶

• https://py-kms.readthedocs.io/en/latest/Getting%20Started.html
• https://github.com/Py-KMS-Organization/py-kms
• https://py-kms.readthedocs.io/en/latest/Usage.html#activation-procedure