Project to install Docker and Docker-Compose in Ubuntu, Raspberry or Nanopi
Make your projects come to life with Docker
- Documentación oficial: 📁Documentación docker 📁Documentación hub 📁Documentación docker compose
Primero, actualice su lista de paquetes existente:
sudo apt update
A continuación, instale algunos paquetes de requisitos previos que permitan a apt usar paquetes a través de HTTPS:
sudo apt install apt-transport-https ca-certificates curl software-properties-common
Luego, añada la clave de GPG para el repositorio oficial de Docker en su sistema:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
Agregue el repositorio de Docker a las fuentes de APT:
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu focal stable"
A continuación, actualice el paquete de base de datos con los paquetes de Docker del repositorio recién agregado:
sudo apt update
Por último, instale Docker:
sudo apt install docker-ce
Compruebe que funcione:
sudo systemctl status docker
Ejecutar el comando Docker sin sudo, si desea evitar escribir sudo al ejecutar el comando docker, agregue su nombre de usuario al grupo docker:
sudo usermod -aG docker ${USER}
El siguiente comando descargará la versión 2.2.2 y guardará el archivo ejecutable en /usr/local/bin/docker-compose, que hará que este software esté globalmente accesible como docker-compose, Si desea descargar la versión más reciente, ir al enlace: https://github.com/docker/compose/releases y modificar la versión:
sudo curl -L "https://github.com/docker/compose/releases/download/1.26.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
Le damos permisos de ejecución:
sudo chmod +x /usr/local/bin/docker-compose
Para verificar que la instalación se realizó correctamente, puede ejecutar:
docker-compose --version
Instalar los kernel-headers para el sistema operativo. Esto es importante, ya que si no instala los encabezados del kernel, Docker no funcionará.
sudo apt install raspberrypi-kernel raspberrypi-kernel-headers
Primero, actualice su lista de paquetes existente:
sudo apt update
A continuación, instale algunos paquetes de requisitos previos que permitan a apt usar paquetes a través de HTTPS:
sudo apt install apt-transport-https ca-certificates curl software-properties-common
sudo apt install -y libffi-dev libssl-dev python3 python3-pip
sudo apt install iptables-persistent
sudo apt install unattended-upgrades
Por último, instale Docker:
sudo curl -sSL https://get.docker.com | sh
Compruebe que funcione:
sudo systemctl status docker
Ejecutar el comando Docker sin sudo, si desea evitar escribir sudo al ejecutar el comando docker, agregue su nombre de usuario al grupo docker:
sudo usermod -aG docker ${USER}
El siguiente comando descargará e instalará docker-compose:
sudo apt install -y docker-compose
Para verificar que la instalación se realizó correctamente, puede ejecutar:
docker-compose --version
- traefik - reverse proxy and SSL manager.
- Adguard - Network-wide ads & trackers blocking DNS server.
- Grafana - The open-source platform for monitoring and observability.
- Heimdall - Heimdall is an elegant solution to organise all your web applications.
- Pihole - The Pi-hole® is a DNS sinkhole that protects your devices from unwanted content without installing any client-side software.
- Portainer - Portainer is a lightweight service delivery platform for containerized applications that can be used to manage Docker, Swarm, Kubernetes and ACI environments.
- syncthing - Syncthing is a continuous file synchronization program.
- wikijs - Wiki.js is an open source project that has been made possible due to the generous contributions by community backers.
- fail2ban - security tool (ban IP).
- freshrss - RSS feed aggregator.
- gotify - notification service.
- nextcloud - file-hosting software system.
- transmission - fast, easy, and free BitTorrent client.
- trilium - hierarchical note-taking application.
- vaultwarden - password manager.
- watchtower - automatic docker images update.
- wireguard - Wireguard is a selfhosted vpn.
- wordpress - WordPress is a blogging tool with a content management system (CMS).
The overall guide is centered around example. Each of the services is tied with either a docker-compose or a script, everything has been made so that each service is almost ready to use, only a few user-specific variable are required.
All services respect a certain format :
- About - basic overview of the service
- Table of Contents
- Information - detailed information about the service and the example
- Usage - required configuration and commands to use the service
- Update - how to update the container, most of the time it is using watchtower
UFW is a popular iptables front end on Ubuntu that makes it easy to manage firewall rules. But when Docker is installed, Docker bypass the UFW rules and the published ports can be accessed from outside.
An easy fix is available, allowing to easily manage your firewall. As most of the services are going through Traefik, only the port 443 is mandatory. If another port is required, it will be listed in the requirements.
- Get shell access whilst the container is running
docker exec -it container-name /bin/bash - Monitor the logs of the container in realtime
docker logs -f container-name
Most images are used with the tag latest as it simplify the testing. It is usually not recommended running an image with this tag as it is not very dynamic and precise.
Feel free to experiment with the provided docker-compose examples and then use a better versionning system. For more information about latest.
This repository images are automatically updated with watchtower, however this can be a security risk. More details in the watchtower guide.
If you want to manually update an image, you can use docker-compose.
- Update all images for a specific docker-compose file
sudo docker-compose pull - Update a single image
sudo docker-compose pull image-name - Recreate all updated containers with docker-compose
sudo docker-compose up -d - Recreate a single container with docker-compose
sudo docker-compose up -d container-name - Remove all dangling and unused images
sudo docker image prune -a
Some useful tools to manage your private docker infrastructure.
- lazydocker - A simple terminal UI for both docker and docker-compose, written in Go with the gocui library. By @jesseduffield
- dive - A tool for exploring each layer in a docker image. By @anchore.
- grype - A vulnerability scanner for container images and filesystems. By @anchore.
A compilation of resources mainly focus on security.
- CIS Docker 1.13.0 Benchmark - provides prescriptive guidance for establishing a secure configuration posture for Docker
- Docker security - official docker documentation about security
- Docker security OWASP - OWASP security cheat sheet
Buy me a coffee so I can continue creating content. Invítame a un café para que pueda seguir creando contenidos.
