Docker Installation Guide

Ten przewodnik pokazuje, jak poprawnie zainstalować Dockera na Ubuntu Server 24.04, korzystając z oficjalnego repozytorium.

To podejście jest standardem w środowiskach produkcyjnych, ponieważ zapewnia aktualne wersje, spójność zależności oraz przewidywalny proces aktualizacji.

Dla kogo jest ten artykuł

• administratorzy Ubuntu Server
• osoby przygotowujące VPS lub homelab
• DevOps i inżynierowie infrastruktury
• każdy, kto chce mieć stabilne środowisko Docker

Kroki instalacji

1. Aktualizacja systemu

Zanim zaczniesz, upewnij się, że system jest aktualny:

sudo apt update && sudo apt upgrade -y

2. Instalacja pakietów wymaganych do repozytoriów HTTPS

Przygotowujemy system do korzystania z zewnętrznych repozytoriów:

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y

3. Dodanie klucza GPG Dockera

Klucz GPG pozwala zweryfikować autentyczność pakietów:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

4. Dodanie repozytorium Dockera

Dodajemy oficjalne repozytorium Dockera do APT:

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

5. Odświeżenie listy pakietów

sudo apt update

6. Instalacja Dockera i Compose v2

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

Docker Compose instalowany jest tutaj jako natywny plugin, czyli Compose v2.

Różnica:

• docker-compose to stara wersja 1.x
• docker compose to aktualna wersja 2.x działająca jako plugin

W środowiskach serwerowych należy używać wyłącznie wersji pluginowej.

7. Weryfikacja instalacji

sudo systemctl status docker

Sprawdzenie wersji:

docker --version
docker compose version

8. Praca bez sudo

Sprawdź grupy:

groups $USER

Jeśli nie ma docker:

sudo usermod -aG docker $USER
newgrp docker

9. Test działania

docker run hello-world

Jeśli wszystko działa, zobaczysz komunikat powitalny.

Dlaczego oficjalne repozytorium

• aktualne wersje Dockera
• kompatybilność z ekosystemem
• łatwe aktualizacje systemowe
• brak konfliktów z pakietami systemowymi

To kluczowe w środowiskach produkcyjnych.

Najczęstsze problemy

Docker nie startuje

sudo journalctl -u docker

Brak uprawnień bez sudo

• upewnij się, że jesteś w grupie docker
• wyloguj się i zaloguj ponownie, jeśli to konieczne

Konflikt docker-compose

sudo apt remove docker-compose

Co dalej

Po instalacji warto przejść do:

• podstaw docker run
• tworzenia docker-compose.yml
• zarządzania siecią Dockera
• budowania własnych obrazów

Docker to dopiero początek. Prawdziwa wartość zaczyna się przy automatyzacji i orkiestracji.