It's in The Wiki

User Tools

Site Tools

Trace:
docker

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
docker [2025/06/01 17:12] – [Compose files] admindocker [2026/04/08 22:19] (current) – admin
Line 1: Line 1:
 ====== Docker ====== ====== Docker ======
 +===== Removal =====
 +
 +Back up all volumes
 +
 +  for d in */; do tar -czf "${d%/}_$(date +%Y-%m-%dT%H-%M-%S).tgz" "$d"; done
 +
 +Remove all of docker and start again
 +
 +  sudo systemctl stop docker
 +  sudo apt-get purge -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
 +  sudo rm -rf /var/lib/docker
 +  sudo rm -rf /var/lib/containerd
 +  sudo rm -rf /etc/docker
 +  sudo apt-get autoremove -y
 +
 +===== Fresh install =====
 +
 +Then reinstall via Docker's official repo (not the Ubuntu snap/apt version):
 +
 +  curl -fsSL https://get.docker.com | sh
 +
 +That script installs the latest stable Docker CE with all plugins. After that, add your user to the docker group if needed:
 +
 +sudo usermod -aG docker sean
 +
 +Then re-enable your services:
 +
 +  sudo systemctl enable --now docker
 +  sudo systemctl enable --now hawser
 +
 +===== Enable SSL/TLS connection =====
 +
 +==== Generate a CA, server, and client certificate/key pair ====
 +
 +1. Create a working directory
 +
 +  mkdir -p ~/.docker/tls && cd ~/.docker/tls
 +
 +2. Generate the CA private key
 +
 +  openssl genrsa -aes256 -out ca-key.pem 4096
 +
 +3. Generate the CA certificate
 +
 +  openssl req -new -x509 -days 365 -key ca-key.pem -sha256 -out ca.pem
 +
 +You'll be prompted for a passphrase and subject info (Country, CN, etc.).
 +
 +4. Generate the server private key
 +
 +  openssl genrsa -out server-key.pem 4096
 +
 +5. Generate the server CSR (Certificate Signing Request)
 +
 +  openssl req -subj "/CN=<your-server-hostname-or-IP>" -sha256 -new -key server-key.pem -out server.csr
 +
 +Replace <your-server-hostname-or-IP> with your Docker host's hostname or IP (e.g., mydockerhost or 192.168.1.10).
 +
 +6. Create a SANs (Subject Alternative Names) extension file
 +
 +  echo subjectAltName = DNS:<hostname>,IP:<IP>,IP:127.0.0.1 > extfile.cnf
 +  echo extendedKeyUsage = serverAuth >> extfile.cnf
 +
 +Add all hostnames/IPs clients will use to reach the server.
 +
 +7. Sign the server certificate with the CA
 +
 +  openssl x509 -req -days 365 -sha256 \
 +    -in server.csr -CA ca.pem -CAkey ca-key.pem \
 +    -CAcreateserial -out server-cert.pem -extfile extfile.cnf
 +
 +8. Generate the client private key
 +
 +  openssl genrsa -out key.pem 4096
 +
 +9. Generate the client CSR
 +
 +  openssl req -subj '/CN=client' -new -key key.pem -out client.csr
 +
 +10. Create a client extension file
 +
 +  echo extendedKeyUsage = clientAuth > extfile-client.cnf
 +
 +11. Sign the client certificate with the CA
 +
 +  openssl x509 -req -days 365 -sha256 \
 +    -in client.csr -CA ca.pem -CAkey ca-key.pem \
 +    -CAcreateserial -out cert.pem -extfile extfile-client.cnf
 +
 +12. Clean up CSRs and extension files, lock down permissions
 +
 +  rm -f client.csr server.csr extfile.cnf extfile-client.cnf
 +  chmod 0400 ca-key.pem key.pem server-key.pem
 +  chmod 0444 ca.pem server-cert.pem cert.pem
 +
 +After this you'll have:
 +
 +  ┌──────────────────────────────────┬───────────────────────────────────────────────────┐
 +  │               File               │                      Purpose                      │
 +  ├──────────────────────────────────┼───────────────────────────────────────────────────┤
 +  │ ca.pem                           │ CA certificate (needed by both server and client) │
 +  ├──────────────────────────────────┼───────────────────────────────────────────────────┤
 +  │ server-cert.pem / server-key.pem │ Server certificate and key                        │
 +  ├──────────────────────────────────┼───────────────────────────────────────────────────┤
 +  │ cert.pem / key.pem               │ Client certificate and key                        │
 +  └──────────────────────────────────┴───────────────────────────────────────────────────┘
 +
 +==== Configure /etc/docker/daemon.json with "tls": true, "tlscacert", "tlscert", and "tlskey" ====
 +
 +1. Copy server certs to a permanent location
 +
 +  sudo mkdir -p /etc/docker/certs
 +  sudo cp ~/.docker/tls/ca.pem /etc/docker/certs/
 +  sudo cp ~/.docker/tls/server-cert.pem /etc/docker/certs/
 +  sudo cp ~/.docker/tls/server-key.pem /etc/docker/certs/
 +  sudo chmod 0444 /etc/docker/certs/ca.pem /etc/docker/certs/server-cert.pem
 +  sudo chmod 0400 /etc/docker/certs/server-key.pem
 +
 +2. Create or edit /etc/docker/daemon.json
 +
 +  sudo tee /etc/docker/daemon.json > /dev/null <<EOF
 +  {
 +    "tls": true,
 +    "tlsverify": true,
 +    "tlscacert": "/etc/docker/certs/ca.pem",
 +    "tlscert": "/etc/docker/certs/server-cert.pem",
 +    "tlskey": "/etc/docker/certs/server-key.pem",
 +    "hosts": ["unix:///var/run/docker.sock", "tcp://0.0.0.0:2376"]
 +  }
 +  EOF
 +
 +  - "tls": true — enables TLS but allows unauthenticated clients
 +  - "tlsverify": true — enforces mutual TLS (clients must present a valid cert)
 +  - Port 2376 is the standard TLS Docker port (2375 is unencrypted)
 +
 +3. Handle the hosts conflict with systemd (WSL/Linux)
 +
 +If Docker is managed by systemd, the -H flag in the service file conflicts with hosts in daemon.json. Override it:
 +
 +  sudo mkdir -p /etc/systemd/system/docker.service.d
 +  sudo tee /etc/systemd/system/docker.service.d/override.conf > /dev/null <<EOF
 +  [Service]
 +  ExecStart=
 +  ExecStart=/usr/bin/dockerd
 +  EOF
 +
 +Enable systemd in WSL2 (recommended).
 +
 +Edit /etc/wsl.conf
 +
 +  sudo tee /etc/wsl.conf > /dev/null <<EOF
 +  [boot]
 +  systemd=true
 +  EOF
 +
 +4. Reload and restart Docker
 +
 +  sudo systemctl daemon-reload
 +  sudo systemctl restart docker
 +
 +5. Verify Docker is listening on port 2376
 +
 +  sudo ss -tlnp | grep 2376
 +
 +You should see dockerd bound to 0.0.0.0:2376. That confirms TLS is active and the daemon is accepting remote connections.
 +
 ===== Portainer ===== ===== Portainer =====
 ==== Upgrade Portainer ==== ==== Upgrade Portainer ====
Line 85: Line 251:
 ===== Compose files ===== ===== Compose files =====
 [[Cacti]] [[Cacti]]
 +
 [[Portainer Agent]] [[Portainer Agent]]
 ===== References ===== ===== References =====
docker.1748769159.txt.gz · Last modified: by admin

Page Tools

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki