Initialer Release (v1.0.0)

README.md

@@ -1,9 +1,65 @@
-# template_repository
+# Docker Image Manager
 
+Ein interaktives Bash-Script zum Anzeigen, Filtern und Loeschen von Docker Images. Es listet alle Images inklusive zugeordneter Container, zeigt ungenutzte Images und erlaubt das gezielte Loeschen per Nummer oder den sicheren Massenvorgang per Parameter.
 
+## Voraussetzungen
 
-Wichtig: Link für Lizenz anpassen.
+- Docker installiert und laeuft
+- Bash (unter Windows z.B. via WSL oder Git Bash)
 
+## Nutzung
+
+```bash
+bash ./docker-image-manager.v1.sh
+```
+
+Ohne Parameter startet das interaktive Menu. Dort kannst du Images anzeigen und optional direkt Details zu einem Image abrufen.
+
+### Befehle
+
+- `list` - Alle Docker Images auflisten (inkl. zugeordneter Container)
+- `unused-images` - Images anzeigen, die von keinem Container genutzt werden
+- `inspect` - Details zu einem Image anzeigen (Auswahl per Nummer, inkl. Containerliste)
+- `delete` - Einzelne Images nach Nummer loeschen
+- `purge-unused` - Alle ungenutzten Images loeschen
+- `help` / `-h` / `--help` - Hilfe anzeigen
+
+### Optionen
+
+- `--yes` - Loeschen ohne Rueckfrage
+
+## Beispiele
+
+Alle Images anzeigen:
+
+```bash
+bash ./docker-image-manager.v1.sh list
+```
+
+Alle ungenutzten Images loeschen (mit Rueckfrage):
+
+```bash
+bash ./docker-image-manager.v1.sh purge-unused
+```
+
+Ein Image nach Nummer loeschen:
+
+```bash
+bash ./docker-image-manager.v1.sh delete 3
+```
+
+Image Details inkl. zugeordneter Container anzeigen:
+
+```bash
+bash ./docker-image-manager.v1.sh inspect 2
+```
+
+## Hinweise
+
+- Ungenutzte Images werden ueber alle Container ermittelt (inkl. gestoppter Container).
+- Ungetaggte (dangling) Images haben in der Liste die Tags `<none>:<none>` und tauchen bei "ungenutzt" auf, wenn kein Container sie nutzt.
+- In der Liste zeigt die Spalte `CONTAINERS`, welche Container das Image verwenden.
+- Das Script loescht keine Images, die noch von Containern genutzt werden (weder einzeln noch als Massenloeschung). In diesem Fall werden die Container angezeigt und das Image uebersprungen.
 
 
 <p align="center">
@@ -11,5 +67,5 @@ Wichtig: Link für Lizenz anpassen.
 </p>
 
 <p align="center">
-<img src="https://assets.techniverse.net/f1/logos/small/license.png" alt="License" width="15" height="15"> <a href="./template_repository/src/branch/main/LICENSE">License</a> | <img src="https://assets.techniverse.net/f1/logos/small/matrix2.svg" alt="Matrix" width="15" height="15"> <a href="https://matrix.to/#/#community:techniverse.net">Matrix</a> | <img src="https://assets.techniverse.net/f1/logos/small/mastodon2.svg" alt="Matrix" width="15" height="15"> <a href="https://social.techniverse.net/@donnerwolke">Mastodon</a>
+<img src="https://assets.techniverse.net/f1/logos/small/license.png" alt="License" width="15" height="15"> <a href="./LICENSE">License</a> | <img src="https://assets.techniverse.net/f1/logos/small/matrix2.svg" alt="Matrix" width="15" height="15"> <a href="https://matrix.to/#/#community:techniverse.net">Matrix</a> | <img src="https://assets.techniverse.net/f1/logos/small/mastodon2.svg" alt="Matrix" width="15" height="15"> <a href="https://social.techniverse.net/@donnerwolke">Mastodon</a>
 </p>