Wprowadzenie
Docker Compose to narzędzie do definiowania i uruchamiania wielo-kontenerowych aplikacji Dockera za pomocą prostych plików konfiguracyjnych YAML. Umożliwia łatwe zarządzanie usługami, sieciami i wolumenami w ramach jednej komendy, co jest szczególnie przydatne w środowiskach deweloperskich i produkcyjnych. Ten artykuł opisuje krok po kroku, jak zainstalować Docker Compose na Ubuntu Server.
Wymagania wstępne
- System Ubuntu Server (np. 20.04, 22.04, 24.04).
- Zainstalowany Docker (jeśli nie jest zainstalowany, patrz krok 1).
- Uprawnienia administratora (sudo).
- Połączenie internetowe do pobierania pakietów.
Krok 1: Instalacja Dockera (jeśli nie jest zainstalowany)
Jeśli Docker nie jest jeszcze zainstalowany, wykonaj następujące polecenia:
sudo apt-get update
sudo apt-get install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker
Sprawdź wersję Dockera, aby potwierdzić instalację:
docker --versionKrok 2: Pobranie najnowszej wersji Docker Compose
Docker Compose jest dostępny jako plik binarny w repozytorium GitHub. Sprawdź najnowszą wersję na stronie releases i pobierz ją. Na przykład, dla wersji 2.29.2 (stan na październik 2025):
sudo curl -L "https://github.com/docker/compose/releases/download/v2.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
Uwaga: Zastąp v2.29.2 najnowszą wersją dostępną na stronie GitHub.
Krok 3: Nadanie uprawnień do pliku binarnego
Ustaw uprawnienia wykonywalne dla pliku Docker Compose:
sudo chmod +x /usr/local/bin/docker-compose
Krok 4: Weryfikacja instalacji
Sprawdź, czy Docker Compose został poprawnie zainstalowany, wpisując:
docker-compose --versionPowinieneś zobaczyć wersję, np. docker-compose version 2.29.2.
Krok 5: (Opcjonalne) Dodanie użytkownika do grupy docker
Aby uruch11niać polecenia Docker bez sudo, dodaj użytkownika do grupy docker:
sudo usermod -aG docker $USER
newgrp docker
Zaloguj się ponownie lub uruchom nową sesję terminala, aby zastosować zmiany.
Rozwiązywanie problemów
- Błąd: „command not found”
Upewnij się, że plikdocker-composeznajduje się w/usr/local/bini ma odpowiednie uprawnienia. Sprawdź poprawność ścieżki w poleceniucurl. - Błąd: Brak połączenia internetowego
Sprawdź połączenie sieciowe i upewnij się, że adres URL w poleceniucurljest poprawny. - Problemy z uprawnieniami
Upewnij się, że używaszsudodla poleceń wymagających uprawnień administratora lub że użytkownik należy do grupydocker.
Podsumowanie
Instalacja Docker Compose na Ubuntu Server jest prosta i wymaga jedynie kilku poleceń w terminalu. Po zainstalowaniu możesz używać Docker Compose do zarządzania aplikacjami wielo-kontenerowymi, definiując ich konfigurację w plikach YAML. To narzędzie jest nieocenione dla deweloperów pracujących z Dockerem w środowiskach takich jak Crawl4AI RAG MCP Server czy inne projekty wymagające złożonych ustawień kontenerów.
Źródła: Instrukcje oparte na oficjalnej dokumentacji Docker Compose dostępnej na docs.docker.com.
Instalacja Docker i Docker Compose na Ubuntu Server
Komendy instalacyjne
# Aktualizacja systemu
sudo apt update
sudo apt upgrade -y
# Instalacja Dockera
sudo apt install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker
# Dodanie użytkownika do grupy docker (aby używać bez sudo)
sudo usermod -aG docker $USER
# Instalacja Docker Compose
sudo apt install -y docker-compose
# Wylogowanie i ponowne zalogowanie (aby zmiany w grupie docker były aktywne)
exit
Opis komend
sudo apt update – aktualizuje listy pakietów.
sudo apt upgrade -y – aktualizuje wszystkie pakiety systemowe.
sudo apt install -y docker.io – instaluje Dockera.
sudo systemctl start docker – uruchamia usługę Dockera.
sudo systemctl enable docker – włącza automatyczne uruchamianie Dockera przy starcie systemu.
sudo usermod -aG docker $USER – dodaje bieżącego użytkownika do grupy docker, aby używać Dockera bez sudo.
sudo apt install -y docker-compose – instaluje Docker Compose.
exit – wylogowuje, aby zastosować zmiany w grupach użytkownika.
Sprawdzenie wersji
Po ponownym zalogowaniu sprawdź wersje:
docker --version
docker-compose --version
