Docker op Ubuntu draaiende krijgen is niet altijd een fluitje van een cent, vooral niet als er iets kapotgaat of gewoon niet direct werkt. Misschien heb je geprobeerd het te installeren, maar worden commando’s zoals docker niet herkend, of maken containers gewoon geen verbinding – ja, frustrerende dingen. Deze handleiding behandelt de meest voorkomende methoden, van officiële repository-installaties tot offline pakketten, plus enkele tips voor het oplossen van problemen en het opschonen van oude versies. Want Linux maakt het natuurlijk vaak ingewikkelder dan het zou moeten zijn. Zodra je het hebt geïnstalleerd, kun je containers draaien, lokaal testen of zelfs in productie implementeren. Verwacht een werkende Docker-installatie met minimale moeite, en een aantal tips voor als er iets misgaat.
Hoe u Docker-installatie- en uitvoeringsproblemen op Ubuntu kunt oplossen
Zorg ervoor dat er geen conflicterende of verouderde Docker-pakketten zijn die de boel in de war brengen
Ten eerste komt het zelden voor dat overgebleven pakketten geen problemen veroorzaken. Verwijder alles wat het probleem zou kunnen veroorzaken:
for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove -y "$pkg" done Dit helpt om alles op orde te krijgen. Soms veroorzaken oude versies of conflicterende tools fouten met betrekking tot ‘command not found’ of opstartproblemen met de daemon. In sommige configuraties kan een herstart daarna de boel eindelijk weer synchroon krijgen.
Controleer uw Ubuntu-versie en -architectuur – ken uw omgeving
Controleer voordat u met opdrachten aan de slag gaat, of uw besturingssysteem en CPU-architectuur aan de verwachtingen voldoen. Voer het volgende uit:
source /etc/os-release && echo "Ubuntu codename: ${UBUNTU_CODENAME:-$VERSION_CODENAME}" dpkg --print-architecture Hiermee bevestigt u dat u met de juiste repository- en pakketversies werkt. Soms leidt een verkeerde architectuur tot kapotte installaties of niet-overeenkomende pakketten.
Methode 1: Docker installeren vanuit de officiële APT-repository
Dit is dé oplossing voor de meeste mensen die een stabiele, eenvoudig te beheren setup zoeken. Je krijgt de nieuwste officiële Docker-versie met updates rechtstreeks van de bron. Dit helpt afhankelijkheidsdrempels te vermijden.
Installeer de vereiste pakketten en voeg een GPG-sleutel toe
Deze stap installeert tools zoals ca-certificates en curl, en voegt bovendien de GPG-sleutel van Docker toe. Het is vrij eenvoudig, maar als je hier een stap overslaat, kan apt niet verifiëren dat je legitieme Docker-pakketten ophaalt, wat niet goed is.
sudo apt-get update sudo apt-get install -y ca-certificates curl 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 Voeg de officiële repository van Docker toe
Hier vertelt u uw systeem waar Docker-pakketten te vinden zijn. Het is een eenvoudige echo-opdracht, maar zorg ervoor dat u $(./etc/os-release && echo “${UBUNTU_CODENAME}”) correct vervangt. Soms wordt de opdracht niet zoals verwacht uitgevouwen, vooral als uw besturingssysteem niet standaard is.
echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \ $(./etc/os-release && echo "${UBUNTU_CODENAME}") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt-get update Docker Engine en CLI-tools installeren
Installeer nu de daadwerkelijke containers en CLI. Meestal werkt dit soepel, maar als je een vreemde configuratie hebt, moet je mogelijk specifieke versienummers opgeven of controleren op defecte afhankelijkheden.
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin Controleer of Docker is geïnstalleerd en actief is
Als er geen fouten optreden, controleer dan de status van de daemon:
sudo systemctl status docker --no-pager docker run hello-world Deze test haalt een kleine afbeelding op en voert deze uit. Als het werkt, is je Docker-configuratie in principe goed. Op sommige machines moet je je gebruiker mogelijk voor het gemak aan de Docker-groep toevoegen:
sudo usermod -aG docker $USER newgrp docker docker run hello-world Ik weet niet waarom, maar soms is newgrp of opnieuw aanmelden nodig om groepswijzigingen door te voeren zonder dat opnieuw opstarten nodig is.
Specifieke Docker-versies upgraden of installeren
Als u een specifieke versie nodig hebt, controleer dan de beschikbare versies met:
apt-cache madison docker-ce | awk '{ print $3 }' Installeer vervolgens uw keuze zoals:
sudo apt-get install -y docker-ce=<version> docker-ce-cli=<version> containerd.io Soms hebt u vanwege compatibiliteitsredenen een specifieke build nodig. Houd er rekening mee dat downgrades of specifieke versies bij sommige configuraties lastig kunnen zijn als de repositories niet zijn bijgewerkt.
Methode 2: Offline installeren via.deb-pakketten
Ideaal wanneer servers geïsoleerd zijn of de internettoegang onregelmatig is. Je moet eerst alle bestanden downloaden en ze vervolgens lokaal installeren.
Docker-pakketten handmatig downloaden
Ga naar Docker’s Ubuntu-repository en kies je architectuur (zoals amd64 of arm64 ).Haal deze.deb-bestanden op:
containerd.io_<version>_<arch>.debdocker-ce_<version>_<arch>.debdocker-ce-cli_<version>_<arch>.debdocker-buildx-plugin_<version>_<arch>.debdocker-compose-plugin_<version>_<arch>.deb
Nadat u het hebt gedownload, installeert u alles in één keer:
sudo dpkg -i./containerd.io_*_*.deb \./docker-ce_*_*.deb \./docker-ce-cli_*_*.deb \./docker-buildx-plugin_*_*.deb \./docker-compose-plugin_*_*.deb Dit voelt wat omslachtiger, maar het is de enige optie zonder internet en op sommige systemen werkt het betrouwbaarder.
Methode 3: Gebruik het officiële gemaksscript van Docker
Als snelheid belangrijker is dan beveiliging (niet aanbevolen voor productie!), voer dan gewoon het volgende uit:
curl -fsSL https://get.docker.com -o get-docker.sh sudo sh./get-docker.sh --dry-run # preview, then run without --dry-run sudo sh./get-docker.sh Deze methode downloadt alles en installeert het met minimale moeite. Het nadeel? Geen controle over versies of afhankelijkheden, en het is nogal dubieus voor kritieke systemen.
Docker Desktop installeren op Ubuntu
Voor een GUI-ervaring met Docker voegt Desktop een laag gebruiksgemak toe – een beetje zoals Docker in je systeemvak. Je hebt Ubuntu 22.04 of nieuwer nodig, met GNOME Terminal als je geen GNOME gebruikt.
Desktop-repository instellen en installeren
Herhaal in principe de repo-installatie van Methode 1, maar installeer vervolgens:
sudo apt-get install -y./docker-desktop-amd64.deb Start en schakel automatisch starten in:
systemctl --user start docker-desktop systemctl --user enable docker-desktop Controles na installatie en veelvoorkomende probleemoplossing
docker run hello-world docker run -d -p 8080:80 --name web nginx docker ps sudo systemctl enable docker Enkele typische problemen:
docker: command not found→ Installeer Docker CLI opnieuw of controleer of uw PATH /usr/bin of /usr/local/bin bevat.- Kan geen verbinding maken met daemon → Controleer of de Docker-service actief is en of uw gebruiker deel uitmaakt van de docker -groep.
- Fouten bij het ophalen van afbeeldingen → Controleer netwerkinstellingen, proxy, DNS of tijdsynchronisatie (NTP).Soms kan Docker Docker Hub niet bereiken.
- Problemen met firewall → Mogelijk moet u regels toevoegen in de DOCKER-USER- keten of uw firewall om containerpoortverkeer toe te staan.
Docker verwijderen indien nodig
sudo apt-get purge -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras sudo rm -rf /var/lib/docker /var/lib/containerd sudo rm -f /etc/apt/sources.list.d/docker.list /etc/apt/keyrings/docker.asc Afronding
Docker installeren op Ubuntu kan een beetje lastig lijken, vooral met alle bewegende onderdelen: kernelversies, afhankelijkheden, firewall-zaken. Maar als het eenmaal werkt, is het behoorlijk solide voor containerbeheer. De officiële methoden bestrijken vrijwel elk scenario, van online installaties tot offline configuraties, en probleemoplossingsstappen kunnen de problemen meestal verhelpen. Als de configuratie eindelijk werkt, is dat een opluchting en kun je vrijwel direct beginnen met het bouwen of implementeren van containers.
Samenvatting
- Verwijder eerst conflicterende pakketten
- Kies de juiste installatiemethode op basis van uw omgeving
- Controleer of Docker werkt met een snelle containertest
- Houd Docker up-to-date en controleer indien nodig de firewallregels
- Verwijder oudere instellingen op een schone manier als u van methode wisselt