normalize readme

.dockerignore

@@ -0,0 +1,5 @@
+.git*
+*.md
+LICENSE
+maintain/
+project*

.github/workflows/release.yml

@@ -0,0 +1,26 @@
+name: create release notes
+
+on:
+  push:
+    tags:
+      - "*"
+      - "!amd64*"
+      - "!arm64*"
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: release
+    runs-on: ubuntu-latest
+    steps:
+      - name: create release notes
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          tag: ${{ github.ref_name }}
+        run: |
+          gh release create "$tag" \
+              --repo="$GITHUB_REPOSITORY" \
+              --title="${tag#v}" \
+              --generate-notes

README.md

@@ -1,7 +1,7 @@
 ![Banner](https://github.com/11notes/defaults/blob/main/static/img/banner.png?raw=true)
 
 # 🏔️ Alpine - kms
-![size](https://img.shields.io/docker/image-size/11notes/kms/latest?color=0eb305) ![version](https://img.shields.io/docker/v/11notes/kms/latest?color=eb7a09) ![pulls](https://img.shields.io/docker/pulls/11notes/kms?color=2b75d6) ![stars](https://img.shields.io/docker/stars/11notes/kms?color=e6a50e) [<img src="https://img.shields.io/badge/github-11notes-blue?logo=github">](https://github.com/11notes)
+![size](https://img.shields.io/docker/image-size/11notes/kms/latest?color=0eb305) ![version](https://img.shields.io/docker/v/11notes/kms/latest?color=eb7a09) ![pulls](https://img.shields.io/docker/pulls/11notes/kms?color=2b75d6)
 
 **Activate any version of Windows and Office, forever**
 
@@ -46,7 +46,9 @@ services:
     environment:
       TZ: Europe/Zurich
     volumes:
-      - "kms-var:/kms/var"
+      - "var:/kms/var"
+    ports:
+      - "1688:1688/tcp"
     restart: always
   whodb:
     image: "11notes/whodb:latest"
@@ -59,7 +61,7 @@ services:
       - "8080:8080/tcp"
     restart: always
 volumes:
-  kms-var:
+  var:
 ```
 
 # EXAMPLES
@@ -79,6 +81,7 @@ Activate server
 slmgr /ato
 ```
 
+# DEFAULT SETTINGS
 # DEFAULT SETTINGS
 | Parameter | Value | Description |
 | --- | --- | --- |
@@ -101,6 +104,9 @@ slmgr /ato
 | `KMS_RENEWALINTERVAL` | re-activation after N minutes | 259200 (180 days) |
 | `KMS_LOGLEVEL` | CRITICAL, ERROR, WARNING, INFO, DEBUG, MININFO | INFO |
 
+# SOURCE
+* [11notes/kms:latest](https://github.com/11notes/docker-kms/tree/latest)
+
 # PARENT IMAGE
 * [11notes/alpine:stable](https://hub.docker.com/r/11notes/alpine)
 

amd64.dockerfile

@@ -1,3 +1,11 @@
+# :: Util
+  FROM alpine as util
+
+  RUN set -ex; \
+    apk add --no-cache \
+      git; \
+    git clone https://github.com/11notes/util.git;
+
 # :: Build
   FROM alpine as build
 
@@ -18,6 +26,7 @@
 # :: Header
   FROM python:3.11-alpine
   COPY --from=build /usr/local/bin/ /usr/local/bin
+  COPY --from=util /util/docker /usr/local/bin
   ENV APP_ROOT=/kms
   ENV APP_NAME="kms"
   ENV APP_VERSION="latest"

arm64v8.dockerfile

@@ -1,6 +1,14 @@
 # :: QEMU
   FROM multiarch/qemu-user-static:x86_64-aarch64 as qemu
 
+# :: Util
+  FROM alpine as util
+
+  RUN set -ex; \
+    apk add --no-cache \
+      git; \
+    git clone https://github.com/11notes/util.git;
+
 # :: Build
   FROM alpine as build
 
@@ -22,6 +30,7 @@
   FROM --platform=linux/arm64 arm64v8/python:3.11-alpine
   COPY --from=qemu /usr/bin/qemu-aarch64-static /usr/bin
   COPY --from=build /usr/local/bin/ /usr/local/bin
+  COPY --from=util /util/docker /usr/local/bin
   ENV APP_ROOT=/kms
   ENV APP_NAME="kms"
   ENV APP_VERSION="latest"

compose.yaml

@@ -6,7 +6,9 @@ services:
     environment:
       TZ: Europe/Zurich
     volumes:
-      - "kms-var:/kms/var"
+      - "var:/kms/var"
+    ports:
+      - "1688:1688/tcp"
     restart: always
   whodb:
     image: "11notes/whodb:latest"
@@ -14,9 +16,9 @@ services:
     environment:
       TZ: Europe/Zurich
     volumes:
-      - "kms-var:/whodb/var"
+      - "var:/whodb/var"
     ports:
       - "8080:8080/tcp"
     restart: always
 volumes:
-  kms-var:
+  var:

rootfs/usr/local/bin/entrypoint.sh

@@ -1,6 +1,6 @@
 #!/bin/ash
-  if [ -z "$1" ]; then
+  if [ -z "${1}" ]; then
-    elevenLogJSON info "starting ${APP_NAME} (${APP_VERSION})"
+    elevenLogJSON info "starting ${APP_NAME}"
     set -- "python3" \
       /usr/local/bin/py-kms/pykms_Server.py \
       ${KMS_IP} \