IT

Applicazioni

Installare Docker Engine e Docker Compose

Installa Docker Engine e Docker Compose dal repository ufficiale su Debian o Ubuntu: utenti, log, porte, aggiornamenti, backup e buone pratiche.

6 min di lettura, aggiornato il 18 novembre 2026

In questa pagina

Questa guida ti spiega come installare Docker Engine e il plugin Docker Compose dal repository ufficiale di Docker, poi come preparare il tuo server per un uso in produzione: permessi degli utenti, rotazione dei log, esposizione delle porte, aggiornamenti e backup.

Ordina un server

Per ospitare i tuoi container, HostMyServers offre diverse soluzioni:

Prerequisiti

  • Un server a 64 bit con Debian 12/13 o Ubuntu 22.04/24.04
  • Un accesso SSH con root o con un utente sudo

Porte: Docker non ha bisogno di alcuna porta in ingresso. Apri solo le porte delle applicazioni che pubblichi e non esporre mai l'API di Docker (2375 o 2376) su Internet: accedervi equivale a controllare il server.

Passo 1: rimuovere i pacchetti in conflitto

I pacchetti Docker forniti dalla distribuzione possono entrare in conflitto con quelli ufficiali:

Terminale
sudo apt update
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc 2>/dev/null | cut -f1)

Le eventuali immagini e i volumi in /var/lib/docker non vengono eliminati da questo comando.

Passo 2: aggiungere il repository ufficiale

Questi comandi vanno bene sia per Debian sia per Ubuntu, perché leggono il sistema da /etc/os-release:

Terminale
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
. /etc/os-release
sudo curl -fsSL "https://download.docker.com/linux/$ID/gpg" -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/$ID
Suites: ${UBUNTU_CODENAME:-$VERSION_CODENAME}
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

Passo 3: installare Docker

Terminale
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker containerd

Passo 4: verificare l'installazione

Terminale
sudo systemctl status docker
docker --version
docker compose version
sudo docker run --rm hello-world

Il messaggio Hello from Docker! conferma che il motore può scaricare un'immagine e avviare un container.

Passo 5: autorizzare un utente

Per usare Docker senza sudo, aggiungi il tuo utente al gruppo docker, poi disconnettiti e riconnettiti:

Terminale
sudo usermod -aG docker $USER

Verifica poi:

Terminale
docker run --rm hello-world

Passo 6: configurare i log e il demone

Per impostazione predefinita, il driver json-file non limita la dimensione dei log, che possono finire per riempire il disco. Crea /etc/docker/daemon.json:

Terminale
sudo nano /etc/docker/daemon.json
JSON
{
  "log-driver": "local",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  },
  "live-restore": true
}
Opzione Effetto
log-driver: local Formato di log compatto, con rotazione
max-size, max-file Fino a 3 file da 10 MB per container
live-restore I container continuano a funzionare se il demone si ferma

Convalida il file, poi riavvia Docker. Questo riavvio interrompe i container in esecuzione: fallo preferibilmente prima di distribuire le tue applicazioni.

Terminale
sudo dockerd --validate --config-file=/etc/docker/daemon.json
sudo systemctl restart docker
docker info --format '{{.LoggingDriver}} {{.LiveRestoreEnabled}}'

Il driver dei log si applica solo ai nuovi container. Ricrea i container esistenti per beneficiarne, per esempio con docker compose up -d --force-recreate.

Passo 7: controllare le porte pubblicate

Se sul server è in esecuzione un reverse proxy, pubblica le tue applicazioni solo in locale:

YAML
ports:
  - "127.0.0.1:8080:80"

Puoi anche rendere l'indirizzo locale il comportamento predefinito, aggiungendo queste chiavi in /etc/docker/daemon.json:

JSON
{
  "ip": "127.0.0.1",
  "default-network-opts": {
    "bridge": {
      "com.docker.network.bridge.host_binding_ipv4": "127.0.0.1"
    }
  }
}

Uniscile al file del passo 6, convalidalo, poi riavvia Docker. Una porta destinata al pubblico dovrà allora essere indicata esplicitamente, per esempio "0.0.0.0:443:443".

Passo 8: avviare un primo progetto Compose

Crea una cartella per il progetto:

Terminale
sudo mkdir -p /opt/myapp
sudo chown "$USER": /opt/myapp
cd /opt/myapp
nano compose.yaml
YAML
services:
  web:
    image: nginx:1.30-alpine
    restart: unless-stopped
    ports:
      - "127.0.0.1:8080:80"
    volumes:
      - web-data:/usr/share/nginx/html
    healthcheck:
      test: ["CMD", "wget", "-qO-", "http://127.0.0.1/"]
      interval: 30s
      timeout: 5s
      retries: 3

volumes:
  web-data:

Avvia e poi verifica:

Terminale
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=20 web
curl -I http://127.0.0.1:8080

Per pubblicare questa applicazione in HTTPS, metti davanti ad essa un reverse proxy. Puoi partire dalla guida Installare Nginx e PHP-FPM e dalla guida Let's Encrypt.

Comandi utili

Comando Descrizione
docker ps -a Elencare i container
docker compose logs -f Seguire i log del progetto
docker compose restart Riavviare i servizi
docker compose down Fermare ed eliminare i container, conservando i volumi
docker system df Mostrare lo spazio utilizzato

Aggiornamenti

Docker Engine

Terminale
sudo apt update
sudo apt install --only-upgrade docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker --version

live-restore copre solo gli aggiornamenti correttivi. Per una versione maggiore, prevedi un'interruzione dei tuoi container e consulta le note di rilascio di Docker.

Immagini delle applicazioni

Modifica il tag in compose.yaml se lo fissi, poi:

Terminale
cd /opt/myapp
docker compose pull
docker compose up -d
docker image prune

Backup

Fai il backup almeno dei tuoi file Compose, dei tuoi file .env e dei tuoi volumi. I volumi si trovano in /var/lib/docker/volumes, ma è meglio archiviarli tramite un container temporaneo. Il nome reale del volume si ottiene con docker volume ls:

Terminale
cd /opt/myapp
mkdir -p backups
docker compose stop web
docker run --rm -v myapp_web-data:/data:ro -v "$PWD/backups":/backup alpine:3 tar czf /backup/web-data.tar.gz -C /data .
docker compose start web

Per ripristinare l'archivio in un volume:

Terminale
docker compose stop web
docker run --rm -v myapp_web-data:/data -v "$PWD/backups":/backup:ro alpine:3 tar xzf /backup/web-data.tar.gz -C /data
docker compose start web

Per un database, preferisci un'esportazione con lo strumento del motore (mariadb-dump, pg_dump, ecc.). Copia poi i tuoi backup fuori dal server.

Buone pratiche in produzione

  • Fissa una versione precisa dell'immagine anziché latest
  • Definisci restart: unless-stopped e un healthcheck per i tuoi servizi
  • Pubblica il minor numero possibile di porte, e in locale dietro un reverse proxy quando possibile
  • Conserva i tuoi segreti in un file .env protetto (chmod 600 .env), fuori da Git
  • Non usare privileged: true e non montare /var/run/docker.sock senza necessità
  • Tieni sotto controllo lo spazio su disco con docker system df
  • Testa regolarmente il ripristino dei tuoi backup

In caso di problemi

permission denied su /var/run/docker.sock

Il tuo utente non è ancora preso in considerazione nel gruppo docker. Verifica con id, poi riconnettiti via SSH.

Conflicting values set for option Signed-By

Resta una vecchia configurazione del repository Docker, spesso /etc/apt/sources.list.d/docker.list. Dopo aver controllato il suo contenuto, eliminala:

Terminale
sudo rm /etc/apt/sources.list.d/docker.list
sudo apt update

Cannot connect to the Docker daemon

Terminale
sudo systemctl status docker
sudo journalctl -u docker -n 50 --no-pager
sudo dockerd --validate --config-file=/etc/docker/daemon.json

Un errore di sintassi in daemon.json impedisce l'avvio del servizio.

port is already allocated o address already in use

Un altro container o servizio usa questa porta. Individualo con sudo ss -ltnp | grep ':8080 ' e docker ps, poi cambia la porta lato server.

no space left on device

Terminale
df -h
docker system df
docker image prune
docker builder prune

Usa docker volume prune solo dopo aver verificato che i volumi interessati non contengano più dati utili.

toomanyrequests durante un download

Il limite di download di Docker Hub è stato raggiunto. Attendi, oppure accedi al tuo account con docker login.

docker-compose: command not found

Il plugin attuale si usa con uno spazio: docker compose.

Una porta resta accessibile nonostante UFW

È il comportamento normale delle porte pubblicate da Docker. Pubblica la porta su 127.0.0.1 oppure applica le restrizioni della guida Configurare UFW.

Riferimenti