Instalar MySQL

Instalar MySQL es el primer paso para empezar a trabajar con bases de datos. En esta guía cubriremos la instalación en los tres sistemas operativos principales: Windows, macOS y Linux. Al final del proceso tendrás un servidor MySQL funcionando y listo para recibir conexiones.

Elegir la versión adecuada

MySQL ofrece dos ediciones principales. La Community Edition es gratuita, de código abierto y perfectamente adecuada para desarrollo, aprendizaje y la mayoría de proyectos en producción. La Enterprise Edition añade herramientas de monitorización, backup avanzado y soporte técnico de Oracle, pero requiere una licencia comercial.

Para seguir este tutorial, la Community Edition es todo lo que necesitas. Te recomendamos instalar la versión 8.0 LTS o 8.4 LTS, ya que son versiones estables con soporte extendido.

Instalación en Windows

Usando MySQL Installer

La forma más sencilla de instalar MySQL en Windows es mediante el instalador oficial, que incluye el servidor, el cliente de línea de comandos, MySQL Workbench y otros componentes útiles.

Descarga el instalador desde la página oficial de descargas de MySQL Community. Verás dos opciones: el instalador web (que descarga los componentes durante la instalación) y el instalador completo (que incluye todo en un solo archivo). Si tienes buena conexión a internet, el instalador web es suficiente.

Al ejecutar el instalador, selecciona el tipo de instalación Developer Default. Esta opción instala el servidor MySQL, MySQL Workbench, MySQL Shell y los conectores más comunes. Si solo necesitas el servidor, puedes elegir Server only.

Durante la configuración, el instalador te pedirá que establezcas la contraseña del usuario root. Este es el usuario administrador con acceso total al servidor. Elige una contraseña segura y anótala en un lugar seguro, ya que la necesitarás para conectarte.

MySQL Server 8.4 - Configuración
================================
Tipo de configuración: Development Computer
Puerto: 3306
Método de autenticación: caching_sha2_password (recomendado)
Contraseña de root: ********
Servicio de Windows: MySQL84 (inicio automático)

El instalador configurará MySQL como un servicio de Windows que se inicia automáticamente con el sistema. Esto significa que no tendrás que arrancar el servidor manualmente cada vez que enciendas tu computadora.

Verificar la instalación en Windows

Abre una ventana de PowerShell o Símbolo del sistema y ejecuta:

mysql --version

Deberías ver algo como mysql Ver 8.4.x for Win64 on x86_64. Si el comando no se reconoce, es probable que el directorio bin de MySQL no esté en tu variable de entorno PATH. Por defecto, MySQL se instala en C:\Program Files\MySQL\MySQL Server 8.4\bin.

Para añadirlo al PATH, abre las variables de entorno del sistema y agrega esa ruta a la variable PATH. Después, cierra y vuelve a abrir la terminal.

Instalación en macOS

Usando Homebrew

Homebrew es el gestor de paquetes más popular en macOS y la forma más cómoda de instalar MySQL. Si no tienes Homebrew instalado, puedes hacerlo ejecutando el comando de instalación disponible en la web oficial de Homebrew.

Una vez tengas Homebrew, instalar MySQL es un solo comando:

brew install mysql

Homebrew descargará y compilará MySQL junto con todas sus dependencias. El proceso puede tomar unos minutos. Cuando termine, verás instrucciones para iniciar el servicio.

Para que MySQL se inicie automáticamente al arrancar el sistema:

brew services start mysql

Si prefieres iniciar MySQL manualmente solo cuando lo necesites:

mysql.server start

Configuración inicial en macOS

Después de la instalación, MySQL viene con el usuario root sin contraseña. Esto es conveniente para empezar rápidamente, pero inseguro. Ejecuta el script de seguridad para configurar una contraseña y reforzar la instalación:

mysql_secure_installation

Este script interactivo te guiará a través de varias preguntas. Te pedirá que establezcas la contraseña de root, te preguntará si quieres eliminar los usuarios anónimos (responde que sí), si deseas deshabilitar el acceso remoto de root (sí, para desarrollo local) y si quieres eliminar la base de datos de prueba (sí). Cada una de estas opciones mejora la seguridad de tu instalación.

Usando el paquete DMG oficial

Si prefieres no usar Homebrew, puedes descargar el archivo DMG desde la página de descargas de MySQL. Abre el archivo DMG, ejecuta el instalador PKG y sigue las instrucciones en pantalla. Al finalizar, encontrarás un panel de preferencias de MySQL en Preferencias del Sistema donde podrás iniciar y detener el servidor.

Con la instalación DMG, el ejecutable mysql se encuentra en /usr/local/mysql/bin/. Para usarlo directamente desde la terminal, añade esa ruta a tu archivo de perfil:

echo 'export PATH="/usr/local/mysql/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Instalación en Linux

Ubuntu / Debian

En distribuciones basadas en Debian, MySQL está disponible en los repositorios oficiales. Actualiza la lista de paquetes e instala el servidor:

sudo apt update
sudo apt install mysql-server

Durante la instalación, dependiendo de la versión de Ubuntu, el sistema puede pedirte que configures la contraseña de root o puede dejar la autenticación usando el socket del sistema (auth_socket). Con auth_socket, el usuario root de MySQL solo puede conectarse desde el usuario root del sistema operativo, sin necesidad de contraseña.

Una vez instalado, verifica que el servicio está corriendo:

sudo systemctl status mysql

Deberías ver active (running) en la salida. Si el servicio no está activo, inícialo con:

sudo systemctl start mysql
sudo systemctl enable mysql

El segundo comando asegura que MySQL se inicie automáticamente en cada reinicio del sistema.

Ejecuta el script de seguridad para proteger tu instalación:

sudo mysql_secure_installation

Si MySQL usa auth_socket para root, primero conéctate como root y establece una contraseña:

sudo mysql
 
ALTER USER 'root'@'localhost' IDENTIFIED WITH caching_sha2_password BY 'tu_contraseña_segura';
FLUSH PRIVILEGES;
EXIT;

CentOS / RHEL / Fedora

En distribuciones basadas en Red Hat, necesitas añadir el repositorio oficial de MySQL. Descarga e instala el paquete de configuración del repositorio:

sudo dnf install https://dev.mysql.com/get/mysql84-community-release-fc39-1.noarch.rpm
sudo dnf install mysql-community-server

Inicia el servicio y habilítalo para que arranque automáticamente:

sudo systemctl start mysqld
sudo systemctl enable mysqld

En CentOS/RHEL, MySQL genera una contraseña temporal para root durante la instalación. Encuéntrala en el log:

sudo grep 'temporary password' /var/log/mysqld.log

Usa esa contraseña temporal para conectarte por primera vez y cámbiala inmediatamente:

mysql -u root -p

ALTER USER 'root'@'localhost' IDENTIFIED BY 'NuevaContraseña_Segura1!';

La política de contraseñas de MySQL por defecto requiere al menos 8 caracteres, una mayúscula, una minúscula, un número y un carácter especial.

Instalación con Docker

Docker es una alternativa excelente para desarrollo, ya que permite tener MySQL funcionando en segundos sin modificar tu sistema. Es especialmente útil si trabajas con varios proyectos que requieren diferentes versiones de MySQL.

docker run --name mysql-tutorial \
    -e MYSQL_ROOT_PASSWORD=mi_contraseña \
    -p 3306:3306 \
    -d mysql:8.4

Este comando descarga la imagen de MySQL 8.4, crea un contenedor llamado mysql-tutorial, establece la contraseña de root y mapea el puerto 3306 del contenedor al puerto 3306 de tu máquina. La opción -d ejecuta el contenedor en segundo plano.

Para conectarte al servidor MySQL dentro del contenedor:

docker exec -it mysql-tutorial mysql -u root -p

Si quieres que los datos persistan cuando el contenedor se reinicie, monta un volumen:

docker run --name mysql-tutorial \
    -e MYSQL_ROOT_PASSWORD=mi_contraseña \
    -p 3306:3306 \
    -v mysql-data:/var/lib/mysql \
    -d mysql:8.4

Verificar que MySQL funciona correctamente

Independientemente del método de instalación que hayas elegido, la prueba definitiva es conectarse al servidor y ejecutar una consulta. Abre una terminal y ejecuta:

mysql -u root -p

Introduce tu contraseña cuando se solicite. Si la conexión es exitosa, verás el prompt de MySQL:

Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 8
Server version: 8.4.0 MySQL Community Server - GPL

mysql>

Ejecuta una consulta simple para confirmar que todo funciona:

SELECT VERSION(), CURRENT_DATE, CURRENT_USER();

Si ves esta salida, tu instalación está completa y funcionando. Escribe EXIT; o \q para cerrar la conexión.

Solución de problemas comunes

El comando mysql no se reconoce. Esto significa que el directorio bin de MySQL no está en tu PATH. Localiza la instalación de MySQL en tu sistema y añade la ruta del directorio bin a la variable de entorno PATH.

"Access denied for user 'root'@'localhost'". La contraseña es incorrecta o el método de autenticación no coincide. En Ubuntu con auth_socket, intenta sudo mysql en lugar de mysql -u root -p. En otros sistemas, verifica que estés usando la contraseña que configuraste durante la instalación.

"Can't connect to local MySQL server through socket". El servicio MySQL no está corriendo. Inícialo con sudo systemctl start mysql en Linux, brew services start mysql en macOS, o verifica que el servicio MySQL está activo en el Administrador de servicios de Windows.

El puerto 3306 ya está en uso. Otra instancia de MySQL u otro servicio está usando ese puerto. Verifica qué proceso lo está ocupando con lsof -i :3306 en macOS/Linux o netstat -ano | findstr :3306 en Windows. Puedes detener ese proceso o configurar MySQL para usar un puerto diferente editando el archivo de configuración my.cnf o my.ini.

En el siguiente artículo aprenderás a conectarte al servidor MySQL y ejecutar tus primeras consultas.