docker images

Wyświetla listę obrazów dostępnych lokalnie.

docker images wyświetla listę obrazów Dockera, które masz pobrane lokalnie — czyli te ściągnięte przez docker pull albo zbudowane przez docker build. Dostajesz tabelę z kolumnami REPOSITORY, TAG, IMAGE ID, CREATED i SIZE. To pierwsze polecenie, po które sięgasz, gdy chcesz sprawdzić, co właściwie zajmuje miejsce na dysku, albo gdy uruchamiasz kontener i nie pamiętasz, czy dany obraz już jest na maszynie. Warto wiedzieć, że docker images to po prostu starszy alias dla nowszego docker image ls — oba robią dokładnie to samo.

Składnia i najważniejsze opcje

Podstawowa składnia: docker images [OPTIONS] [REPOSITORY[:TAG]]

  • -a, --all — pokazuje wszystkie obrazy, łącznie z pośrednimi warstwami, które normalnie są ukryte.
  • -q, --quiet — wypisuje tylko IMAGE ID, bez reszty kolumn. Idealne do podawania dalej w skryptach.
  • --digests — dorzuca kolumnę z digestem (sumą SHA256), przydatne przy precyzyjnym przypinaniu wersji.
  • --no-trunc — nie skraca IMAGE ID; widzisz pełny identyfikator zamiast obciętego.
  • -f, --filter — filtruje wynik po kluczu, np. dangling=true albo reference=nginx.
  • --format — formatuje wyjście według szablonu Go, możesz też użyć table z własnymi kolumnami.

Przykłady użycia

  • docker images — wyświetla wszystkie obrazy najwyższego poziomu w czytelnej tabeli.
  • docker images nginx — pokazuje wyłącznie obrazy z repozytorium nginx i wszystkimi jego tagami.
  • docker images -q — zwraca same ID, więc możesz je podać dalej, np. docker rmi $(docker images -q), żeby skasować wszystkie obrazy.
  • docker images -f "dangling=true" — wylistowuje osierocone obrazy bez taga (te oznaczone jako ), które zwykle warto posprzątać.
  • docker images --format "{{.Repository}}:{{.Tag}} {{.Size}}" — drukuje tylko nazwę z tagiem i rozmiar, świetne do szybkiego raportu.

Częste błędy i pułapki

Rozmiar w kolumnie SIZE potrafi mylić — to rozmiar logiczny obrazu, a nie miejsce realnie zajęte na dysku. Obrazy współdzielą warstwy, więc dziesięć obrazów po 200 MB nie znaczy 2 GB na dysku. Jeśli chcesz prawdę o zajętości, użyj docker system df. Druga pułapka: docker images nie pokazuje kontenerów — od tego jest docker ps. Łatwo też pomylić skasowanie obrazu (docker rmi) z usunięciem kontenera (docker rm); jeśli obraz jest używany przez działający kontener, Docker odmówi usunięcia, dopóki go nie zatrzymasz. I pamiętaj, że -a pokazuje warstwy pośrednie, których zwykle nie chcesz kasować ręcznie — od czyszczenia śmieci jest docker image prune.

Powiązane komendy: docker pull, docker rmi, docker image prune, docker ps, docker system df, docker build.