Objetivo del proyecto

En esta práctica vamos a crear un entorno de desarrollo web usando Docker. El objetivo es tener un sistema parecido a XAMPP o MAMP, pero más profesional, portable y fácil de reconstruir.

El entorno permitirá trabajar con:

• Apache
• PHP
• Extensiones comunes de PHP
• MySQL
• phpMyAdmin
• Mailpit para probar correos
• Redis como servicio adicional opcional
• Una carpeta local donde guardaremos todos nuestros proyectos web

Todos los contenedores tendrán el prefijo:

DEV_

De esta forma podremos identificarlos fácilmente dentro de Docker.

---

1. ¿Qué vamos a construir?

El sistema tendrá esta estructura:

Carpeta local del alumno
        │
        ▼
+-----------------------------+
|      Carpeta DEVLOCAL       |
|                             |
|  proyecto1/                 |
|  proyecto2/                 |
|  pruebas/                   |
|  _docker/                   |
+-------------+---------------+
              │
              ▼
+-----------------------------+
|      Docker Compose         |
+-------------+---------------+
              │
              ▼
+-----------------------------+
| DEV_apache_php              |
| DEV_mysql                   |
| DEV_phpmyadmin              |
| DEV_mailpit                 |
| DEV_redis                   |
+-----------------------------+

El alumno podrá crear una carpeta con un proyecto PHP y verlo desde el navegador.

Por ejemplo:

http://localhost:8080/pruebas/

---

2. Requisitos previos

Cada alumno necesitará:

• Un ordenador con Windows, Ubuntu o macOS.
• Docker instalado.
• Un editor de código, por ejemplo VS Code.
• Terminal o consola.
• Navegador web.

Docker Compose se usará para definir y levantar varios contenedores a la vez. Docker lo describe como una herramienta para definir y ejecutar aplicaciones multicontenedor.

---

3. Instalación de Docker en Windows

En Windows se recomienda usar Docker Desktop.

Docker Desktop para Windows incluye Docker Engine, Docker CLI y Docker Compose. La documentación oficial indica que Docker Desktop puede usar WSL 2 como motor de ejecución en Windows.

Pasos recomendados

1. Instalar o activar WSL 2.
2. Instalar Docker Desktop para Windows.
3. Reiniciar el equipo si lo solicita.
4. Abrir Docker Desktop.
5. Comprobar que Docker está funcionando.

Desde PowerShell o Terminal de Windows:

docker --version
docker compose version

Si ambos comandos responden con una versión, Docker está funcionando correctamente.

Carpeta recomendada en Windows

Para evitar problemas con permisos o sincronización, se recomienda crear la carpeta directamente en C:\.

mkdir C:\DEVLOCAL

No es recomendable usar carpetas dentro de OneDrive para este tipo de práctica.

---

4. Instalación de Docker en Ubuntu

En Ubuntu se puede instalar Docker Engine directamente desde los repositorios oficiales de Docker. La documentación oficial recomienda configurar primero el repositorio apt de Docker y después instalar Docker Engine y sus plugins.

Actualizar paquetes

sudo apt update
sudo apt upgrade -y

Instalar dependencias

sudo apt install -y ca-certificates curl gnupg

Crear carpeta para claves

sudo install -m 0755 -d /etc/apt/keyrings

Descargar clave oficial de Docker

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

Dar permisos a la clave

sudo chmod a+r /etc/apt/keyrings/docker.gpg

Añadir repositorio oficial

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Instalar Docker

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Comprobar instalación

docker --version
docker compose version

Permitir usar Docker sin sudo

sudo usermod -aG docker $USER

Después de este comando, el alumno debe cerrar sesión y volver a entrar.

Carpeta recomendada en Ubuntu

mkdir -p ~/DEVLOCAL

---

5. Instalación de Docker en macOS

En macOS se recomienda instalar Docker Desktop para Mac. La documentación oficial diferencia entre Mac con chip Intel y Mac con Apple Silicon, por lo que hay que descargar la versión adecuada.

Pasos recomendados

1. Descargar Docker Desktop para Mac.
2. Elegir la versión correcta:
   • Mac Intel.
   • Mac Apple Silicon.
3. Instalar la aplicación.
4. Abrir Docker Desktop.
5. Esperar a que Docker arranque completamente.
6. Comprobar desde Terminal:

docker --version
docker compose version

Carpeta recomendada en macOS

En el caso de este ejemplo usaremos:

/Users/antoniooteroveiga/DEVLOCAL

Para otro usuario sería algo similar a:

/Users/nombre_usuario/DEVLOCAL

---

6. Crear la estructura del proyecto

La estructura será la misma en Windows, Ubuntu y macOS.

Windows

Desde PowerShell:

mkdir C:\DEVLOCAL
mkdir C:\DEVLOCAL\_docker
mkdir C:\DEVLOCAL\_docker\php
mkdir C:\DEVLOCAL\_docker\apache
mkdir C:\DEVLOCAL\pruebas

Ubuntu

Desde Terminal:

mkdir -p ~/DEVLOCAL/_docker/php
mkdir -p ~/DEVLOCAL/_docker/apache
mkdir -p ~/DEVLOCAL/pruebas

macOS

Desde Terminal:

mkdir -p /Users/antoniooteroveiga/DEVLOCAL/_docker/php
mkdir -p /Users/antoniooteroveiga/DEVLOCAL/_docker/apache
mkdir -p /Users/antoniooteroveiga/DEVLOCAL/pruebas

La estructura final será:

DEVLOCAL/
├── _docker/
│   ├── docker-compose.yml
│   ├── inicio.sh
│   ├── inicio.bat
│   ├── php/
│   │   ├── Dockerfile
│   │   ├── php.ini
│   │   └── msmtprc
│   └── apache/
│       └── 000-default.conf
└── pruebas/
    └── index.php

---

7. Crear el archivo docker-compose.yml

Este archivo define todos los servicios del entorno.

Debe estar dentro de:

DEVLOCAL/_docker/docker-compose.yml

Contenido:

services:

  apache_php:
    build:
      context: .
      dockerfile: php/Dockerfile
    container_name: DEV_apache_php
    restart: unless-stopped
    ports:
      - "8080:80"
    volumes:
      - ../:/var/www/html
      - ./apache/000-default.conf:/etc/apache2/sites-available/000-default.conf
      - ./php/php.ini:/usr/local/etc/php/conf.d/dev-custom.ini
      - ./php/msmtprc:/etc/msmtprc
    depends_on:
      - mysql
      - mailpit
    networks:
      - DEV_network

  mysql:
    image: mysql:8.4
    container_name: DEV_mysql
    restart: unless-stopped
    ports:
      - "3307:3306"
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: devdb
      MYSQL_USER: devuser
      MYSQL_PASSWORD: devpass
    volumes:
      - DEV_mysql_data:/var/lib/mysql
    networks:
      - DEV_network

  phpmyadmin:
    image: phpmyadmin:latest
    container_name: DEV_phpmyadmin
    restart: unless-stopped
    ports:
      - "8081:80"
    environment:
      PMA_HOST: mysql
      PMA_PORT: 3306
      PMA_USER: root
      PMA_PASSWORD: root
      UPLOAD_LIMIT: 256M
    depends_on:
      - mysql
    networks:
      - DEV_network

  mailpit:
    image: axllent/mailpit:latest
    container_name: DEV_mailpit
    restart: unless-stopped
    ports:
      - "8025:8025"
      - "1025:1025"
    networks:
      - DEV_network

  redis:
    image: redis:latest
    container_name: DEV_redis
    restart: unless-stopped
    ports:
      - "6379:6379"
    networks:
      - DEV_network

volumes:
  DEV_mysql_data:

networks:
  DEV_network:
    name: DEV_network

---

8. Crear el archivo Dockerfile

Este archivo construirá nuestro contenedor de Apache con PHP.

Debe estar en:

DEVLOCAL/_docker/php/Dockerfile

Contenido:

FROM php:8.3-apache

RUN apt-get update && apt-get install -y \
    git \
    unzip \
    zip \
    curl \
    msmtp \
    msmtp-mta \
    libzip-dev \
    libpng-dev \
    libjpeg-dev \
    libfreetype6-dev \
    libicu-dev \
    libonig-dev \
    libxml2-dev \
    libssl-dev \
    && docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install \
        mysqli \
        pdo \
        pdo_mysql \
        zip \
        gd \
        intl \
        mbstring \
        bcmath \
        soap \
        opcache \
    && a2enmod rewrite headers expires \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*

COPY --from=composer:latest /usr/bin/composer /usr/bin/composer

WORKDIR /var/www/html

Con esto tendremos disponibles muchas extensiones habituales de PHP:

• mysqli
• pdo_mysql
• gd
• zip
• intl
• mbstring
• bcmath
• soap
• opcache

También tendremos instalado Composer, muy útil para proyectos PHP modernos.

---

9. Crear el archivo php.ini

Debe estar en:

DEVLOCAL/_docker/php/php.ini

Contenido:

display_errors = On
display_startup_errors = On
error_reporting = E_ALL

upload_max_filesize = 256M
post_max_size = 256M
memory_limit = 512M
max_execution_time = 300
max_input_vars = 5000

date.timezone = Europe/Madrid

opcache.enable = 1
opcache.enable_cli = 1

sendmail_path = "/usr/bin/msmtp -t"

Este archivo ajusta PHP para un entorno de desarrollo.

No es una configuración pensada para producción. En producción no deberíamos mostrar errores directamente al usuario.

---

10. Crear el archivo msmtprc

Este archivo permitirá enviar correos desde PHP hacia Mailpit.

Debe estar en:

DEVLOCAL/_docker/php/msmtprc

Contenido:

defaults
auth off
tls off

account mailpit
host mailpit
port 1025
from devlocal@example.test

account default : mailpit

Mailpit capturará los correos y podremos verlos desde el navegador.

---

11. Crear la configuración de Apache

Debe estar en:

DEVLOCAL/_docker/apache/000-default.conf

Contenido:

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/html

    <Directory /var/www/html>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/dev_error.log
    CustomLog ${APACHE_LOG_DIR}/dev_access.log combined
</VirtualHost>

La directiva importante es:

AllowOverride All

Esto permite usar archivos .htaccess, necesarios en muchos proyectos PHP, como WordPress, Laravel o aplicaciones con URLs amigables.

---

12. Crear una página de prueba

Creamos el archivo:

DEVLOCAL/pruebas/index.php

Contenido:

<?php

echo "<h1>Entorno DEV funcionando</h1>";
echo "<p>Apache y PHP están funcionando correctamente.</p>";

echo "<h2>Información de PHP</h2>";
phpinfo();

---

13. Levantar el entorno manualmente

Windows

Desde PowerShell:

cd C:\DEVLOCAL\_docker
docker compose up -d --build

Ubuntu

Desde Terminal:

cd ~/DEVLOCAL/_docker
docker compose up -d --build

macOS

Desde Terminal:

cd /Users/antoniooteroveiga/DEVLOCAL/_docker
docker compose up -d --build

---

14. Comprobar los contenedores

Ejecutamos:

docker ps

Deberíamos ver contenedores parecidos a estos:

DEV_apache_php
DEV_mysql
DEV_phpmyadmin
DEV_mailpit
DEV_redis

---

15. Acceder al entorno desde el navegador

Apache + PHP

http://localhost:8080

Proyecto de pruebas

http://localhost:8080/pruebas/

phpMyAdmin

http://localhost:8081

Datos de acceso:

Servidor: mysql
Usuario: root
Contraseña: root

También podemos usar:

Servidor: mysql
Usuario: devuser
Contraseña: devpass

Mailpit

http://localhost:8025

MySQL desde el equipo anfitrión

Para conectarse desde DBeaver, DataGrip, VS Code o MySQL Workbench:

Host: localhost
Puerto: 3307
Usuario: devuser
Contraseña: devpass
Base de datos: devdb

MySQL desde PHP

Desde código PHP, el host no será localhost, sino el nombre del servicio Docker:

Host: mysql
Puerto: 3306
Usuario: devuser
Contraseña: devpass
Base de datos: devdb

---

16. Probar conexión con MySQL desde PHP

Creamos el archivo:

DEVLOCAL/pruebas/mysql.php

Contenido:

<?php

$host = "mysql";
$db = "devdb";
$user = "devuser";
$pass = "devpass";

$conexion = new mysqli($host, $user, $pass, $db);

if ($conexion->connect_error) {
    die("Error de conexión: " . $conexion->connect_error);
}

echo "<h1>Conexión correcta con MySQL</h1>";
echo "<p>La base de datos devdb está disponible.</p>";

$conexion->close();

Abrimos en el navegador:

http://localhost:8080/pruebas/mysql.php

Si todo está correcto, veremos un mensaje confirmando la conexión.

---

17. Probar envío de correo con Mailpit

Creamos el archivo:

DEVLOCAL/pruebas/mail.php

Contenido:

<?php

$destino = "alumno@example.test";
$asunto = "Prueba desde PHP";
$mensaje = "Este correo ha sido enviado desde PHP y capturado por Mailpit.";
$cabeceras = "From: devlocal@example.test";

if (mail($destino, $asunto, $mensaje, $cabeceras)) {
    echo "<h1>Correo enviado correctamente</h1>";
    echo "<p>Abre Mailpit para verlo.</p>";
} else {
    echo "<h1>Error al enviar el correo</h1>";
}

Abrimos:

http://localhost:8080/pruebas/mail.php

Después entramos en Mailpit:

http://localhost:8025

Ahí debería aparecer el correo capturado.

---

18. Crear script de inicio para Ubuntu y macOS

Creamos el archivo:

DEVLOCAL/_docker/inicio.sh

Contenido:

#!/bin/bash

clear

echo "=============================================="
echo "     ENTORNO DEVLOCAL - DOCKER PHP MYSQL"
echo "=============================================="
echo ""

DEV_PATH="$(cd "$(dirname "$0")" && pwd)"

cd "$DEV_PATH" || exit 1

echo "Levantando contenedores DEV..."
echo ""

docker compose up -d

echo ""
echo "Esperando a que los servicios arranquen..."
sleep 3

echo ""
echo "=============================================="
echo "     CONTENEDORES ACTIVOS"
echo "=============================================="
echo ""

docker ps --filter "name=DEV_"

echo ""
echo "=============================================="
echo "     INFORMACION DE CONEXION"
echo "=============================================="
echo ""

echo "Servidor Apache + PHP:"
echo "  URL principal:      http://localhost:8080"
echo "  Carpeta web:        Carpeta DEVLOCAL del alumno"
echo ""

echo "Proyecto de prueba:"
echo "  http://localhost:8080/pruebas/"
echo ""

echo "phpMyAdmin:"
echo "  URL:                http://localhost:8081"
echo "  Servidor:           mysql"
echo "  Usuario root:       root"
echo "  Password root:      root"
echo ""

echo "MySQL desde PHP:"
echo "  Host:               mysql"
echo "  Puerto:             3306"
echo "  Base de datos:      devdb"
echo "  Usuario:            devuser"
echo "  Password:           devpass"
echo ""

echo "MySQL desde el equipo:"
echo "  Host:               localhost"
echo "  Puerto:             3307"
echo "  Base de datos:      devdb"
echo "  Usuario:            devuser"
echo "  Password:           devpass"
echo ""

echo "Mailpit:"
echo "  Panel web:          http://localhost:8025"
echo "  SMTP interno:       mailpit:1025"
echo ""

echo "Redis:"
echo "  Host desde Docker:  redis"
echo "  Host desde equipo:  localhost"
echo "  Puerto:             6379"
echo ""

echo "=============================================="
echo "     COMANDOS UTILES"
echo "=============================================="
echo ""

echo "Parar entorno:"
echo "  docker compose down"
echo ""

echo "Ver logs:"
echo "  docker compose logs -f"
echo ""

echo "Entrar al contenedor PHP:"
echo "  docker exec -it DEV_apache_php bash"
echo ""

echo "Entrar a MySQL:"
echo "  docker exec -it DEV_mysql mysql -u root -p"
echo ""

echo "=============================================="
echo "     ENTORNO DEV LISTO"
echo "=============================================="
echo ""

Damos permisos de ejecución:

chmod +x inicio.sh

Lo ejecutamos:

./inicio.sh

---

19. Crear script de inicio para Windows

Creamos el archivo:

DEVLOCAL/_docker/inicio.bat

Contenido:

@echo off
cls

echo ==============================================
echo      ENTORNO DEVLOCAL - DOCKER PHP MYSQL
echo ==============================================
echo.

cd /d "%~dp0"

echo Levantando contenedores DEV...
echo.

docker compose up -d

echo.
echo Esperando a que los servicios arranquen...
timeout /t 3 > nul

echo.
echo ==============================================
echo      CONTENEDORES ACTIVOS
echo ==============================================
echo.

docker ps --filter "name=DEV_"

echo.
echo ==============================================
echo      INFORMACION DE CONEXION
echo ==============================================
echo.

echo Servidor Apache + PHP:
echo   URL principal:      http://localhost:8080
echo   Carpeta web:        Carpeta DEVLOCAL del alumno
echo.

echo Proyecto de prueba:
echo   http://localhost:8080/pruebas/
echo.

echo phpMyAdmin:
echo   URL:                http://localhost:8081
echo   Servidor:           mysql
echo   Usuario root:       root
echo   Password root:      root
echo.

echo MySQL desde PHP:
echo   Host:               mysql
echo   Puerto:             3306
echo   Base de datos:      devdb
echo   Usuario:            devuser
echo   Password:           devpass
echo.

echo MySQL desde Windows:
echo   Host:               localhost
echo   Puerto:             3307
echo   Base de datos:      devdb
echo   Usuario:            devuser
echo   Password:           devpass
echo.

echo Mailpit:
echo   Panel web:          http://localhost:8025
echo   SMTP interno:       mailpit:1025
echo.

echo Redis:
echo   Host desde Docker:  redis
echo   Host desde Windows: localhost
echo   Puerto:             6379
echo.

echo ==============================================
echo      COMANDOS UTILES
echo ==============================================
echo.

echo Parar entorno:
echo   docker compose down
echo.

echo Ver logs:
echo   docker compose logs -f
echo.

echo Entrar al contenedor PHP:
echo   docker exec -it DEV_apache_php bash
echo.

echo Entrar a MySQL:
echo   docker exec -it DEV_mysql mysql -u root -p
echo.

echo ==============================================
echo      ENTORNO DEV LISTO
echo ==============================================
echo.

pause

Para ejecutarlo, el alumno puede hacer doble clic sobre inicio.bat o ejecutarlo desde PowerShell.

---

20. Script para parar el entorno

Ubuntu y macOS

Creamos:

DEVLOCAL/_docker/parar.sh

Contenido:

#!/bin/bash

cd "$(dirname "$0")" || exit 1

echo "Parando entorno DEV..."
docker compose down

echo "Entorno detenido."

Permisos:

chmod +x parar.sh

Ejecución:

./parar.sh

Windows

Creamos:

DEVLOCAL/_docker/parar.bat

Contenido:

@echo off
cls

cd /d "%~dp0"

echo Parando entorno DEV...
docker compose down

echo.
echo Entorno detenido.
pause

---

21. Comandos básicos que debe conocer el alumno

Levantar contenedores

docker compose up -d

Levantar y reconstruir

docker compose up -d --build

Parar contenedores

docker compose down

Ver contenedores activos

docker ps

Ver todos los contenedores

docker ps -a

Ver logs

docker compose logs -f

Ver logs de un servicio concreto

docker compose logs -f apache_php

Entrar al contenedor de PHP

docker exec -it DEV_apache_php bash

Entrar al contenedor de MySQL

docker exec -it DEV_mysql mysql -u root -p

Contraseña:

root

---

22. Crear varios proyectos web

El alumno puede crear diferentes carpetas dentro de DEVLOCAL.

Por ejemplo:

DEVLOCAL/
├── pruebas/
├── tienda/
├── blog/
├── reservas/
└── ejercicios_php/

Cada proyecto se abrirá desde el navegador así:

http://localhost:8080/pruebas/
http://localhost:8080/tienda/
http://localhost:8080/blog/
http://localhost:8080/reservas/
http://localhost:8080/ejercicios_php/

---

23. Ejercicio práctico

Parte 1: Comprobar PHP

Crear una carpeta llamada:

alumno_php

Dentro crear un archivo:

index.php

Con este contenido:

<?php

$nombre = "Alumno";
$curso = "Desarrollo Web con PHP";

echo "<h1>Hola, $nombre</h1>";
echo "<p>Estamos trabajando en el curso de $curso.</p>";

Abrir:

http://localhost:8080/alumno_php/

---

Parte 2: Comprobar MySQL

Crear un archivo:

conexion.php

Contenido:

<?php

$conexion = new mysqli("mysql", "devuser", "devpass", "devdb");

if ($conexion->connect_error) {
    die("Error: " . $conexion->connect_error);
}

echo "Conexión correcta con MySQL";

Abrir:

http://localhost:8080/alumno_php/conexion.php

---

Parte 3: Crear una tabla desde phpMyAdmin

Entrar en:

http://localhost:8081

Seleccionar la base de datos:

devdb

Crear una tabla llamada:

alumnos

Con estos campos:

Campo	Tipo	Extra
id	INT	AUTO_INCREMENT, PRIMARY KEY
nombre	VARCHAR(100)
email	VARCHAR(150)
fecha_alta	DATETIME

SQL:

CREATE TABLE alumnos (
    id INT AUTO_INCREMENT PRIMARY KEY,
    nombre VARCHAR(100) NOT NULL,
    email VARCHAR(150) NOT NULL,
    fecha_alta DATETIME DEFAULT CURRENT_TIMESTAMP
);

Insertar datos:

INSERT INTO alumnos (nombre, email) VALUES
('Ana', 'ana@example.test'),
('Luis', 'luis@example.test'),
('Marta', 'marta@example.test');

---

Parte 4: Leer datos desde PHP

Crear:

listar.php

Contenido:

<?php

$conexion = new mysqli("mysql", "devuser", "devpass", "devdb");

if ($conexion->connect_error) {
    die("Error: " . $conexion->connect_error);
}

$resultado = $conexion->query("SELECT * FROM alumnos");

echo "<h1>Listado de alumnos</h1>";

echo "<table border='1' cellpadding='8'>";
echo "<tr>";
echo "<th>ID</th>";
echo "<th>Nombre</th>";
echo "<th>Email</th>";
echo "<th>Fecha de alta</th>";
echo "</tr>";

while ($fila = $resultado->fetch_assoc()) {
    echo "<tr>";
    echo "<td>" . $fila["id"] . "</td>";
    echo "<td>" . $fila["nombre"] . "</td>";
    echo "<td>" . $fila["email"] . "</td>";
    echo "<td>" . $fila["fecha_alta"] . "</td>";
    echo "</tr>";
}

echo "</table>";

$conexion->close();

Abrir:

http://localhost:8080/alumno_php/listar.php

---

24. Preguntas de reflexión para el alumno

1. ¿Qué diferencia hay entre instalar Apache, PHP y MySQL directamente en el sistema y hacerlo con Docker?
2. ¿Qué ventaja tiene que todos los servicios estén definidos en un archivo docker-compose.yml?
3. ¿Por qué PHP se conecta a MySQL usando el host mysql y no localhost?
4. ¿Qué es un volumen en Docker?
5. ¿Dónde se guardan los datos de MySQL en este proyecto?
6. ¿Qué pasaría si ejecutamos docker compose down -v?
7. ¿Para qué sirve phpMyAdmin?
8. ¿Para qué sirve Mailpit?
9. ¿Por qué no deberíamos usar contraseñas como root o devpass en producción?
10. ¿Qué diferencia hay entre un entorno de desarrollo y un entorno de producción?

---

25. Problemas frecuentes

Docker no arranca en Windows

Posibles causas:

• Docker Desktop no está abierto.
• WSL 2 no está instalado o activado.
• La virtualización está desactivada en BIOS/UEFI.
• El equipo necesita reiniciarse.

Docker recomienda usar el backend WSL 2 en Windows para Docker Desktop.

---

El puerto 8080 ya está ocupado

Puede ocurrir si otro servicio ya está usando ese puerto.

Solución: cambiar en docker-compose.yml:

ports:
  - "8080:80"

Por ejemplo:

ports:
  - "8090:80"

Después habría que entrar por:

http://localhost:8090

---

El puerto 3307 ya está ocupado

Cambiar:

ports:
  - "3307:3306"

Por ejemplo:

ports:
  - "3308:3306"

---

No aparecen los cambios en PHP

Probar a recargar el navegador con:

Ctrl + F5

También se puede reiniciar el contenedor:

docker compose restart apache_php

---

Error de permisos en Ubuntu

Si Docker pide sudo, puede faltar añadir el usuario al grupo docker.

sudo usermod -aG docker $USER

Después hay que cerrar sesión y volver a entrar.

---

phpMyAdmin no conecta

Comprobar que MySQL está activo:

docker ps

También se pueden ver los logs:

docker compose logs -f mysql

---

26. Cómo borrar todo y empezar de nuevo

Para parar los contenedores:

docker compose down

Para parar y borrar también los datos de MySQL:

docker compose down -v

Cuidado: este comando borra el volumen de MySQL. Si hay bases de datos creadas, se perderán.

---

29. Ampliaciones posibles

Cuando el entorno básico funcione, se pueden añadir mejoras:

• Crear dominios locales como tienda.localhost.
• Añadir HTTPS local.
• Añadir un contenedor de Node.js.
• Añadir un contenedor específico para Laravel.
• Crear plantillas para WordPress.
• Añadir copias de seguridad automáticas de MySQL.
• Crear un script para exportar e importar bases de datos.
• Crear varios entornos: desarrollo, pruebas y producción.

---

30. Conclusión

Con esta práctica hemos creado un entorno de desarrollo web completo usando Docker. El resultado es similar a XAMPP o MAMP, pero con una ventaja importante: todo el entorno queda definido mediante archivos.

Esto permite:

• Repetir la instalación en diferentes sistemas operativos.
• Compartir el entorno con otros compañeros.
• Evitar conflictos con instalaciones locales.
• Trabajar con varios servicios a la vez.
• Preparar al alumno para entornos profesionales basados en contenedores.

Docker Compose facilita levantar todos los servicios con un solo comando, lo que lo convierte en una herramienta especialmente útil para desarrollo web moderno.

Script Cerrar

Además del script inicio, vamos a crear un script llamado cerrar. Este script no solamente permite apagar el entorno, sino también eliminarlo de diferentes formas según lo que necesitemos. Esto es importante porque no siempre queremos borrar los datos. A veces solo queremos detener los contenedores, y otras veces queremos empezar desde cero.

---

Diferencia entre las opciones

Opción	Comando	¿Borra contenedores?	¿Borra datos MySQL?	¿Borra imágenes?
Parar	docker compose stop	No	No	No
Eliminar contenedores	docker compose down	Sí	No	No
Eliminar con volúmenes	docker compose down -v	Sí	Sí	No
Destruir completo	docker compose down -v --rmi local	Sí	Sí	Sí

---

docker compose stop

Detiene los contenedores, pero no los elimina.

Es como apagar una máquina virtual.

---

docker compose down

Detiene y elimina los contenedores, pero mantiene los volúmenes.

Es decir, si teníamos una base de datos MySQL con datos, normalmente se conservará.

---

docker compose down -v

Detiene y elimina los contenedores, y también borra los volúmenes.

En este proyecto significa que se borrarán los datos de MySQL.

---

docker compose down -v --rmi local

Además de eliminar contenedores y volúmenes, elimina imágenes locales creadas por el proyecto.

En nuestro caso, puede borrar la imagen personalizada de Apache + PHP, por lo que en el siguiente arranque habrá que reconstruirla con:

docker compose up -d --build

---

Recomendación para uso diario

Para el día a día, lo normal es usar la opción:

1) Parar contenedores

o:

2) Parar y eliminar contenedores

La opción 3 y 4 solo deberían usarse cuando queramos empezar desde cero.

Especialmente la opción 3:

docker compose down -v

porque borra los datos de MySQL.

Script para Ubuntu y macOS: cerrar.sh

Crear el archivo:

nano /Users/antoniooteroveiga/DEVLOCAL/_docker/cerrar.sh

Contenido:

#!/bin/bash

clear

echo "=============================================="
echo "        CERRAR ENTORNO DEVLOCAL"
echo "=============================================="
echo ""

DEV_PATH="$(cd "$(dirname "$0")" && pwd)"
cd "$DEV_PATH" || exit 1

echo "Este script permite cerrar o destruir el entorno Docker DEV."
echo ""
echo "Elige una opcion:"
echo ""
echo "  1) Parar contenedores"
echo "     Equivale a: docker compose stop"
echo ""
echo "  2) Parar y eliminar contenedores"
echo "     Equivale a: docker compose down"
echo ""
echo "  3) Parar, eliminar contenedores y borrar volumenes"
echo "     Equivale a: docker compose down -v"
echo "     AVISO: se borraran las bases de datos de MySQL."
echo ""
echo "  4) Parar, eliminar contenedores, volumenes e imagenes del proyecto"
echo "     Equivale a: docker compose down -v --rmi local"
echo "     AVISO: se borraran las bases de datos y las imagenes creadas localmente."
echo ""
echo "  5) Ver contenedores DEV activos"
echo ""
echo "  6) Cancelar"
echo ""

read -p "Selecciona una opcion [1-6]: " opcion

echo ""

case "$opcion" in

  1)
    echo "Parando contenedores..."
    docker compose stop
    echo ""
    echo "Contenedores detenidos."
    ;;

  2)
    echo "Parando y eliminando contenedores..."
    docker compose down
    echo ""
    echo "Contenedores eliminados. Los volumenes se conservan."
    ;;

  3)
    echo "ATENCION: esta opcion borrara los volumenes."
    echo "Esto eliminara los datos persistentes de MySQL."
    echo ""
    read -p "Escribe BORRAR para confirmar: " confirmacion

    if [ "$confirmacion" = "BORRAR" ]; then
      echo ""
      echo "Eliminando contenedores y volumenes..."
      docker compose down -v
      echo ""
      echo "Entorno eliminado con volumenes."
    else
      echo ""
      echo "Operacion cancelada. No se ha borrado nada."
    fi
    ;;

  4)
    echo "ATENCION: esta opcion borrara contenedores, volumenes e imagenes locales."
    echo "Esto eliminara los datos de MySQL y obligara a reconstruir la imagen PHP."
    echo ""
    read -p "Escribe DESTRUIR para confirmar: " confirmacion

    if [ "$confirmacion" = "DESTRUIR" ]; then
      echo ""
      echo "Eliminando contenedores, volumenes e imagenes locales..."
      docker compose down -v --rmi local
      echo ""
      echo "Entorno destruido."
    else
      echo ""
      echo "Operacion cancelada. No se ha borrado nada."
    fi
    ;;

  5)
    echo "Mostrando contenedores DEV..."
    echo ""
    docker ps -a --filter "name=DEV_"
    ;;

  6)
    echo "Operacion cancelada."
    ;;

  *)
    echo "Opcion no valida."
    ;;

esac

echo ""
echo "=============================================="
echo "        PROCESO FINALIZADO"
echo "=============================================="
echo ""

Dar permisos de ejecución:

chmod +x /Users/antoniooteroveiga/DEVLOCAL/_docker/cerrar.sh

Ejecutarlo:

cd /Users/antoniooteroveiga/DEVLOCAL/_docker
./cerrar.sh

---

Versión más portable

Si quieres que funcione sin depender de tu usuario concreto, es mejor decirles que creen el archivo dentro de _docker y que lo ejecuten desde ahí.

cd ~/DEVLOCAL/_docker
nano cerrar.sh
chmod +x cerrar.sh
./cerrar.sh

El script ya detecta automáticamente la carpeta donde está, gracias a esta línea:

DEV_PATH="$(cd "$(dirname "$0")" && pwd)"

Por eso vale tanto para Ubuntu como para macOS.

---

Script para Windows: cerrar.bat

Crear el archivo:

C:\DEVLOCAL\_docker\cerrar.bat

Contenido:

@echo off
cls

cd /d "%~dp0"

:menu
cls
echo ==============================================
echo         CERRAR ENTORNO DEVLOCAL
echo ==============================================
echo.
echo Este script permite cerrar o destruir el entorno Docker DEV.
echo.
echo Elige una opcion:
echo.
echo   1) Parar contenedores
echo      Equivale a: docker compose stop
echo.
echo   2) Parar y eliminar contenedores
echo      Equivale a: docker compose down
echo.
echo   3) Parar, eliminar contenedores y borrar volumenes
echo      Equivale a: docker compose down -v
echo      AVISO: se borraran las bases de datos de MySQL.
echo.
echo   4) Parar, eliminar contenedores, volumenes e imagenes del proyecto
echo      Equivale a: docker compose down -v --rmi local
echo      AVISO: se borraran las bases de datos y las imagenes creadas localmente.
echo.
echo   5) Ver contenedores DEV activos
echo.
echo   6) Cancelar
echo.

set /p opcion=Selecciona una opcion [1-6]: 

if "%opcion%"=="1" goto parar
if "%opcion%"=="2" goto eliminar
if "%opcion%"=="3" goto volumenes
if "%opcion%"=="4" goto destruir
if "%opcion%"=="5" goto ver
if "%opcion%"=="6" goto cancelar

echo.
echo Opcion no valida.
pause
goto menu

:parar
cls
echo Parando contenedores...
echo.
docker compose stop
echo.
echo Contenedores detenidos.
pause
goto fin

:eliminar
cls
echo Parando y eliminando contenedores...
echo.
docker compose down
echo.
echo Contenedores eliminados. Los volumenes se conservan.
pause
goto fin

:volumenes
cls
echo ATENCION: esta opcion borrara los volumenes.
echo Esto eliminara los datos persistentes de MySQL.
echo.
set /p confirmacion=Escribe BORRAR para confirmar: 

if "%confirmacion%"=="BORRAR" (
    echo.
    echo Eliminando contenedores y volumenes...
    docker compose down -v
    echo.
    echo Entorno eliminado con volumenes.
) else (
    echo.
    echo Operacion cancelada. No se ha borrado nada.
)

pause
goto fin

:destruir
cls
echo ATENCION: esta opcion borrara contenedores, volumenes e imagenes locales.
echo Esto eliminara los datos de MySQL y obligara a reconstruir la imagen PHP.
echo.
set /p confirmacion=Escribe DESTRUIR para confirmar: 

if "%confirmacion%"=="DESTRUIR" (
    echo.
    echo Eliminando contenedores, volumenes e imagenes locales...
    docker compose down -v --rmi local
    echo.
    echo Entorno destruido.
) else (
    echo.
    echo Operacion cancelada. No se ha borrado nada.
)

pause
goto fin

:ver
cls
echo Mostrando contenedores DEV...
echo.
docker ps -a --filter "name=DEV_"
echo.
pause
goto menu

:cancelar
cls
echo Operacion cancelada.
pause
goto fin

:fin
cls
echo ==============================================
echo         PROCESO FINALIZADO
echo ==============================================
echo.

---

1. Introducción

En esta práctica vamos a instalar Cypht en una máquina Ubuntu Server.

Cypht es una aplicación web que permite consultar varias cuentas de correo desde una única interfaz. A diferencia de otros clientes webmail más clásicos, Cypht está pensado para actuar como un agregador de cuentas de correo, por lo que resulta especialmente útil cuando queremos gestionar varias direcciones desde el navegador.

Durante la práctica utilizaremos Docker y Docker Compose, ya que esto nos permite instalar Cypht junto con su base de datos de una forma más limpia, controlada y fácil de mantener.

---

2. Objetivos de la práctica

Al finalizar esta práctica, el alumno será capaz de:

• Crear una máquina virtual Ubuntu Server.
• Instalar Docker en Ubuntu Server.
• Usar Docker Compose para desplegar varios servicios.
• Instalar Cypht junto con MariaDB.
• Acceder a Cypht desde un navegador web.
• Comprender el funcionamiento básico de un servicio web desplegado con contenedores.
• Solucionar errores habituales relacionados con permisos de Docker.

---

3. Escenario de la práctica

Vamos a crear el siguiente entorno:

Navegador del alumno
        |
        v
http://IP_DEL_SERVIDOR:8085
        |
        v
Ubuntu Server
        |
        +-- Contenedor Cypht
        |
        +-- Contenedor MariaDB

Cypht será la aplicación web y MariaDB almacenará la configuración y los datos necesarios.

---

4. Requisitos previos

Para realizar esta práctica necesitamos:

• Una máquina virtual con Ubuntu Server 24.04 o similar.
• Acceso a Internet desde la máquina virtual.
• Un usuario con permisos de sudo.
• Al menos:
  • 2 CPU
  • 4 GB de RAM recomendados
  • 25 GB de disco como mínimo
• Conocimientos básicos de terminal Linux.

---

5. Configuración recomendada de la máquina virtual

Si se trabaja con Proxmox, VirtualBox, VMware o similar, se recomienda crear la máquina con estos valores:

Recurso	Valor recomendado
Sistema operativo	Ubuntu Server 24.04
CPU	2 cores
RAM	4 GB
Disco	25 GB mínimo
Red	NAT o adaptador puente
Acceso	Consola o SSH

Importante:
Con 1 CPU y 2 GB de RAM la instalación puede funcionar, pero el sistema irá justo. Para trabajar cómodamente con Docker, Cypht y MariaDB, se recomienda usar 2 CPU y 4 GB de RAM.

---

Parte 1: Preparación del sistema

Paso 1. Actualizar el sistema

sudo apt update

Entramos en la máquina Ubuntu Server y actualizamos los repositorios:

Después actualizamos los paquetes instalados:

sudo apt upgrade -y

---

Paso 2. Instalar herramientas necesarias

Instalamos algunos paquetes que necesitaremos para añadir el repositorio oficial de Docker:

sudo apt install -y ca-certificates curl gnupg

---

Parte 2: Instalación de Docker

Paso 3. Crear el directorio para las claves de Docker

Ejecutamos:

sudo install -m 0755 -d /etc/apt/keyrings

Este directorio se usará para guardar la clave GPG del repositorio oficial de Docker.

---

Paso 4. Descargar la clave GPG de Docker

Ejecutamos:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

Después damos permisos de lectura a la clave:

sudo chmod a+r /etc/apt/keyrings/docker.gpg

---

Paso 5. Añadir el repositorio oficial de Docker

Ejecutamos el siguiente comando completo:

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Actualizamos de nuevo los repositorios:

sudo apt update

---

Paso 6. Instalar Docker y Docker Compose

Instalamos Docker:

sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Comprobamos que Docker se ha instalado correctamente:

docker --version

Y comprobamos Docker Compose:

docker compose version

Si los comandos muestran una versión, la instalación ha sido correcta.

---

Paso 7. Comprobar el estado del servicio Docker

Ejecutamos:

sudo systemctl status docker

Si aparece como active (running), Docker está funcionando.

Podemos salir de esa pantalla pulsando:

q

Si Docker no estuviera activo, lo arrancamos con:

sudo systemctl enable --now docker

---

Parte 3: Preparación de Cypht

Paso 8. Crear la carpeta de trabajo

Crearemos la instalación en /opt/cypht.

sudo mkdir -p /opt/cypht

Cambiamos el propietario de la carpeta para poder trabajar cómodamente con nuestro usuario:

sudo chown -R $USER:$USER /opt/cypht

Entramos en la carpeta:

cd /opt/cypht

---

Paso 9. Crear el archivo docker-compose.yml

Creamos el archivo:

nano docker-compose.yml

Dentro pegamos el siguiente contenido:

services:
  db:
    image: mariadb:10
    container_name: cypht-db
    restart: unless-stopped
    volumes:
      - ./data/mysql:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: Cambia_Esta_Clave_Root
      MYSQL_DATABASE: cypht
      MYSQL_USER: cypht
      MYSQL_PASSWORD: Cambia_Esta_Clave_Cypht
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-ucypht", "-pCambia_Esta_Clave_Cypht"]
      interval: 10s
      timeout: 5s
      retries: 5

  cypht:
    image: cypht/cypht:2.8.0
    container_name: cypht
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    ports:
      - "8085:80"
    environment:
      AUTH_USERNAME: admin
      AUTH_PASSWORD: Cambia_Esta_Clave_Admin

      DB_CONNECTION_TYPE: host
      DB_DRIVER: mysql
      DB_HOST: db
      DB_NAME: cypht
      DB_USER: cypht
      DB_PASS: Cambia_Esta_Clave_Cypht

      SESSION_TYPE: DB
      USER_CONFIG_TYPE: DB
    volumes:
      - ./data/log/nginx:/var/log/nginx
      - ./data/log/php:/var/log/php
      - ./data/log/supervisord:/var/log/supervisord
      - ./data/fonts:/usr/local/share/cypht/site/fonts

Guardamos el archivo en nano:

Ctrl + O
Enter
Ctrl + X

---

Paso 10. Cambiar las contraseñas

Antes de arrancar los contenedores, debemos modificar las siguientes claves:

Cambia_Esta_Clave_Root
Cambia_Esta_Clave_Cypht
Cambia_Esta_Clave_Admin

Podemos editar el archivo de nuevo:

nano docker-compose.yml

Por ejemplo:

MYSQL_ROOT_PASSWORD: Root_1234_segura
MYSQL_PASSWORD: Cypht_1234_segura
AUTH_PASSWORD: Admin_1234_segura
DB_PASS: Cypht_1234_segura

Importante:
La contraseña MYSQL_PASSWORD y la contraseña DB_PASS deben coincidir, porque una define la contraseña del usuario de la base de datos y la otra es la contraseña que usará Cypht para conectarse a esa base de datos.

---

Parte 4: Arranque de Cypht

Paso 11. Levantar los contenedores

Desde la carpeta /opt/cypht, ejecutamos:

sudo docker compose up -d

La opción -d significa que los contenedores se ejecutarán en segundo plano.

---

Paso 12. Comprobar que los contenedores están funcionando

Ejecutamos:

sudo docker ps

Deberíamos ver dos contenedores:

• cypht
• cypht-db

Ejemplo de salida esperada:

CONTAINER ID   IMAGE              PORTS                  NAMES
xxxxxxxxxxxx   cypht/cypht:2.8.0  0.0.0.0:8085->80/tcp   cypht
xxxxxxxxxxxx   mariadb:10         3306/tcp               cypht-db

---

Paso 13. Ver los logs si algo falla

Si algún contenedor no aparece o hay problemas, revisamos los logs:

sudo docker compose logs -f

Para salir de los logs:

Ctrl + C

También podemos ver solo los logs de Cypht:

sudo docker compose logs -f cypht

O solo los de MariaDB:

sudo docker compose logs -f db

---

Parte 5: Acceso desde el navegador

Paso 14. Obtener la IP del servidor

Ejecutamos:

ip a

Buscamos la dirección IP de la tarjeta de red principal. Suele aparecer en interfaces como:

ens18
ens33
eth0
enp0s3

Ejemplo:

inet 192.168.1.80/24

En este caso, la IP sería:

192.168.1.80

---

Paso 15. Entrar en Cypht desde el navegador

Desde el ordenador anfitrión o desde otro equipo de la misma red, abrimos:

http://IP_DEL_SERVIDOR:8085

Por ejemplo:

http://192.168.1.80:8085

El usuario será:

admin

La contraseña será la que hayamos puesto en:

AUTH_PASSWORD

---

Parte 6: Apertura del puerto en el firewall

Paso 16. Comprobar si UFW está activo

Ejecutamos:

sudo ufw status

Si aparece como inactive, no hace falta abrir nada.

Si aparece como active, abrimos el puerto 8085:

sudo ufw allow 8085/tcp

Comprobamos de nuevo:

sudo ufw status

---

Parte 7: Añadir cuentas de correo en Cypht

Paso 17. Datos necesarios para configurar una cuenta

Para añadir una cuenta de correo en Cypht necesitamos conocer los datos del servidor de correo.

Normalmente necesitaremos:

Dato	Ejemplo
Servidor IMAP	mail.midominio.com
Puerto IMAP	993
Seguridad IMAP	SSL/TLS
Usuario	usuario@midominio.com
Contraseña	Contraseña del correo
Servidor SMTP	mail.midominio.com
Puerto SMTP	587
Seguridad SMTP	STARTTLS

---

Paso 18. Añadir una cuenta IMAP

Dentro de Cypht:

1. Entramos con el usuario admin.
2. Accedemos a la configuración.
3. Buscamos la sección de cuentas o servidores IMAP.
4. Añadimos los datos de la cuenta.
5. Guardamos la configuración.

Ejemplo de configuración IMAP:

Servidor IMAP: mail.midominio.com
Puerto: 993
Seguridad: SSL/TLS
Usuario: usuario@midominio.com
Contraseña: ********

---

Paso 19. Añadir una cuenta SMTP

Para poder enviar correos también debemos configurar SMTP.

Ejemplo:

Servidor SMTP: mail.midominio.com
Puerto: 587
Seguridad: STARTTLS
Usuario: usuario@midominio.com
Contraseña: ********

Nota:
En algunos proveedores de correo puede ser necesario activar el acceso por aplicaciones externas o generar una contraseña específica de aplicación.

---

Parte 8: Comandos básicos de administración

Ver contenedores activos

sudo docker ps

---

Ver todos los contenedores, incluso los detenidos

sudo docker ps -a

---

Parar Cypht

cd /opt/cypht
sudo docker compose down

---

Arrancar Cypht de nuevo

cd /opt/cypht
sudo docker compose up -d

---

Reiniciar los contenedores

cd /opt/cypht
sudo docker compose restart

---

Ver logs

cd /opt/cypht
sudo docker compose logs -f

---

Actualizar imágenes

cd /opt/cypht
sudo docker compose pull
sudo docker compose up -d

---

Parte 9: Error habitual de permisos con Docker

Problema

Puede aparecer este error:

unable to get image 'mariadb:10': permission denied while trying to connect to the docker API at unix:///var/run/docker.sock

Este error significa que el usuario actual no tiene permisos para comunicarse con Docker.

---

Solución rápida

Ejecutar el comando con sudo:

sudo docker compose up -d

---

Solución permanente

Añadimos nuestro usuario al grupo docker:

sudo usermod -aG docker $USER

Después reiniciamos la máquina:

sudo reboot

Cuando vuelva a arrancar, comprobamos:

docker ps

Si ya no aparece el error, podremos usar Docker sin sudo.

Importante:
Añadir un usuario al grupo docker le da mucho poder sobre el sistema. En un servidor real, esto debe hacerse solo con usuarios de confianza.

---

Parte 10: Comprobaciones finales

Al terminar la práctica, debemos comprobar:

Comprobación	Resultado esperado
Docker está instalado	docker --version muestra una versión
Docker Compose funciona	docker compose version muestra una versión
Los contenedores están activos	sudo docker ps muestra cypht y cypht-db
Cypht responde en navegador	Se puede acceder a http://IP:8085
El usuario admin funciona	Podemos iniciar sesión
El puerto está abierto	El navegador conecta correctamente
Se puede añadir una cuenta IMAP	La cuenta aparece en Cypht