Instalacja i przygotowanie środowiska Docker

Docker to platforma umożliwiająca uruchamianie aplikacji w lekkich, odizolowanych kontenerach — bez konieczności instalowania pełnego stosu zależności bezpośrednio na systemie operacyjnym.

Dzięki temu serwisy są łatwe w uruchamianiu, aktualizacji i utrzymaniu, a cała infrastruktura (w tym zaplecze smart home) staje się bardziej stabilna, przewidywalna i łatwa w rozbudowie.

W tym poradniku przejdziemy przez kompletny proces instalacji Dockera na Ubuntu — od przygotowania systemu, przez dodanie oficjalnego repozytorium, aż po podstawową konfigurację i test działania. Instrukcja oparta jest na oficjalnej dokumentacji Dockera, ale opisana w sposób praktyczny i krok po kroku, bez skrótów myślowych.

---

1. Przygotowanie systemu (usuwanie poprzednich wersji)

Na początek usuwamy wszystkie potencjalnie zainstalowane pakiety Dockera i kompatybilne zamienniki, żeby uniknąć konfliktów:

sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc | cut -f1)

2. Dodanie oficjalnego repozytorium Docker

Aktualizujemy pakiety i doinstalowujemy wymagane zależności:

sudo apt update
sudo apt install ca-certificates curl

Dodajemy keyring Dockera:

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

I źródła pakietów Dockera:

sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

Odświeżamy listę pakietów:

sudo apt update

3. Instalacja Docker

Instalujemy kompletny pakiet Dockera wraz z Docker Compose v2 oraz BuildX:

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

4. Sprawdzenie statusu usługi

Sprawdzamy, czy Docker działa:

sudo systemctl status docker

Jeśli inactive → odpal:

sudo systemctl start docker

5. Konfiguracja użytkownika (Opcjonalne ale przydatne. komendy docker bez potrzeby używania sudo)

Tworzymy grupę docker:

sudo groupadd docker

Dodajemy swojego użytkownika do tej grupy:

sudo usermod -aG docker $USER

Wymuś przeładowanie grup:

newgrp docker

6. Test działania Docker bez sudo

docker -v

Przykładowy wynik:

Docker version 28.5.1, build e180ab8

Jeśli wcześniej uruchamiałeś Dockera z sudo, może pojawić się błąd uprawnień:

WARNING: Error loading config file: /home/user/.docker/config.json - permission denied

Naprawisz to wykonując:

sudo chown "$USER":"$USER" /home/"$USER"/.docker -R
sudo chmod g+rwx "$HOME/.docker" -R

7. Autostart usług Docker i Containerd

Jeśli chcesz, aby Docker uruchamiał się automatycznie przy starcie systemu:

sudo systemctl enable docker.service
sudo systemctl enable containerd.service

---

Na tym etapie możesz już swobodnie uruchamiać kontenery i całe usługi, jednak aby wszystko wyglądało „jak należy”, warto doinstalować orkiestrator, który pozwoli łatwiej zarządzać całym środowiskiem.