win img use

docs/_openstack/changelog/index.en.md

@@ -14,6 +14,7 @@ Notable Changes on the OpenStack Platform are documented here.
 ### To be announced
 
 - Local Storage Flavor Availability
+- Windows Images GA
 
 ---
 

docs/_openstack/specs/images/index.de.md

@@ -41,6 +41,70 @@ OpenStack und viele Deployment-Tools unterstützen die Verwendung dieser Images
 
 Alle von uns zur Verfügung gestellten Linux-Images sind unmodifiziert und kommen direkt von ihren offiziellen Maintainern. Wir testen sie während des Upload-Prozesses auf Kompatibilität.
 
+## Windows-Images
+
+Wir stellen folgende Windows-Images zur Verfügung:
+
+- Windows Server 2022 GUI
+- Windows Server 2025 GUI
+
+### Verwendung von Windows-Images:
+
+Windows-Images unterstützen das automatische Zurücksetzen des Administrator-Passworts über Instanz-Metadaten:
+
+- Fügen Sie den Metadaten-Schlüssel `admin_pass` mit einem gewünschten Passwort hinzu.
+- Nach dem Neustart der Instanz wird das Administrator-Passwort auf den angegebenen Wert gesetzt.
+
+{: .warning }
+
+Entfernen Sie die Metadaten nach der Erstkonfiguration. Die Metadaten sind **nicht verschlüsselt** und sollten nur für die initiale Passwortvergabe verwendet werden.
+
+Beispiel:
+
+```
+openstack server set --property admin_pass='MeinSicheresPasswort123' INSTANCE_NAME
+```
+
+- Das Passwort wird nach dem nächsten Neustart angewendet.
+- Entfernen Sie anschließend die Metadaten, um die Instanz zu sichern:
+
+```
+openstack server unset --property admin_pass INSTANCE_NAME
+```
+
+Alternativ können Sie sich über SSH und die Floating IP verbinden und das Administrator-Passwort direkt innerhalb der Instanz setzen:
+
+```
+ssh $FLOATING_IP -l Administrator
+```
+
+{: .note }
+
+> Wenn Sie beim Verbindungsaufbau per SSH zur Eingabe eines Passworts aufgefordert werden, warten Sie bitte noch einen Moment. Zu diesem Zeitpunkt sind die Hintergrundprozesse der Instanz möglicherweise noch nicht vollständig abgeschlossen.  
+>
+> Das zu setzende Passwort muss den Standard-Komplexitätsregeln von Windows Server entsprechen. Es muss Zeichen aus mindestens drei der folgenden vier Kategorien enthalten:
+>
+> - Großbuchstaben (A–Z)  
+> - Kleinbuchstaben (a–z)  
+> - Ziffern (0–9)  
+> - Sonderzeichen (z. B. !, $, #, %)  
+>
+> Weitere Informationen finden Sie in der [Microsoft-Dokumentation](https://learn.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2012-r2-and-2012/hh994562(v=ws.11))
+
+```
+administrator@win-server C:\Users\Administrator> powershell
+Windows PowerShell
+Copyright (C) Microsoft Corporation. All rights reserved.
+
+Install the latest PowerShell for new features and improvements! https://aka.ms/PSWindows
+
+PS C:\Users\Administrator> $Password = Read-Host -AsSecureString
+**********
+PS C:\Users\Administrator> Set-LocalUser -Name Administrator -Password $Password
+```
+
+Diese Methode vermeidet, dass das Passwort in unverschlüsselten Metadaten gespeichert wird.
+
 ## Upload von eigenen Images
 
 Sie können jederzeit Ihre eigenen Images hochladen, anstatt die von uns bereit gestellten zu nutzen. Am einfachsten funktioniert das über die OpenStack-CLI.

docs/_openstack/specs/images/index.en.md

@@ -32,6 +32,8 @@ The current list of images is as follows:
 - CoreOS (stable)
 - Rocky Linux 9
 - Flatcar Linux
+- Windows Server 2022 GUI
+- Windows Server 2025 GUI
 
 These images are checked for new releases daily. The latest available version is always a public image, and contains the `Latest`-suffix. All previous versions of an imags are automatically converted to "community images", renamed (`Latest` is replaced by the date of the first upload), and eventially deleted if they are no longer in use at all.
 
@@ -41,6 +43,70 @@ OpenStack and many deployment tools support using these images either by name or
 
 All of our provided linux images are unmodified and come directly from their official maintainers. We test them during the upload process to ensure they are deployable.
 
+## Windows Images
+
+We provide the following Windows images:
+
+- Windows Server 2022 GUI
+- Windows Server 2025 GUI
+
+### Using Windows images:
+
+Windows images support automatic password reset using instance metadata:
+
+- Add metadata key `admin_pass` with a desired password.
+- After the instance reboots, the Administrator password is set to the provided value.
+
+{: .warning }
+
+Remove the metadata after the initial setup. The metadata is **not encrypted** and should only be used for initial password setup.
+
+Example:
+
+```
+openstack server set --property admin_pass='MySecurePassword123!' INSTANCE_NAME
+```
+
+- The password will be applied after the next reboot.
+- Remove metadata afterwards to secure the instance:
+
+```
+openstack server unset --property admin_pass INSTANCE_NAME
+```
+
+Alternatively, you can connect via SSH and the floating IP to set the Administrator password directly inside the instance:
+
+```
+ssh $FLOATING_IP -l Administrator
+```
+
+{: .note }
+
+> If you are prompted for a password when connecting via SSH, please wait a little longer. At that point, the background initialization processes of the instance may not yet be fully completed.  
+>
+> The password you set must comply with Windows Server’s default complexity requirements. It must contain characters from at least three of the following four categories:  
+>
+> - Uppercase letters (A–Z)  
+> - Lowercase letters (a–z)  
+> - Digits (0–9)  
+> - Special characters (e.g., !, $, #, %)  
+>
+> For more information, see the [Microsoft documentation](https://learn.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2012-r2-and-2012/hh994562(v=ws.11)).
+
+```
+administrator@win-server C:\Users\Administrator> powershell
+Windows PowerShell
+Copyright (C) Microsoft Corporation. All rights reserved.
+
+Install the latest PowerShell for new features and improvements! https://aka.ms/PSWindows
+
+PS C:\Users\Administrator> $Password = Read-Host -AsSecureString
+**********
+PS C:\Users\Administrator> Set-LocalUser -Name Administrator -Password $Password
+```
+
+This method avoids storing the password in unencrypted metadata.
+
 ## Uploading your own images
 
 Instead of using the images we provide, you can upload your own images. Easiest way of doing so is to use the OpenStack CLI.