Cómo instalar TYPO3 CMS en Ubuntu 24.04

TYPO3 es un sistema de gestión de contenido de nivel empresarial, gratuito y de código abierto. Proporciona características de nivel empresarial, como un CMS escalable con soporte para múltiples sitios, instalaciones multilingües, una fuerte implementación de seguridad, es extremadamente rápido y se puede ejecutar en cualquier lugar.

Usar TYPO3 CMS te permite construir sitios web flexibles y confiables. El CMS TYPO3 cuenta con el respaldo de una vibrante comunidad profesional. Por diseño, el CMS TYPO3 es un sistema de gestión de contenido modular con una arquitectura adaptable y desacoplada.

En esta guía, instalarás TYPO3 en el servidor Ubuntu 24.04. Instalarás TYPO3 con el LAMP Stack (Linux, Apache, MySQL/MariaDB y PHP), Composer y GraphicsMagick.

Requisitos previos

Para comenzar con esta guía, asegúrate de tener lo siguiente:

• Un servidor Ubuntu 24.04.
• Un usuario no root con privilegios de administrador.
• Un nombre de dominio apuntando a una dirección IP del servidor.

Instalando dependencias

TYPO3 es un sistema de gestión de contenido de código abierto escrito en PHP y soporta bases de datos como MySQL/MariaDB y PostgreSQL. En esta sección, instalarás las dependencias para TYPO3, que incluyen el stack LAMP (Linux, Apache, MySQL/MariaDB y PHP), Composer como gestión de dependencias de PHP, y GraphicsMagick para el procesamiento de imágenes.

Antes de comenzar, actualiza tu índice de paquetes de Ubuntu con el siguiente comando.

sudo apt update

Ahora instala las dependencias del paquete para TYPO3 CMS con el siguiente comando ‘apt install’. Con este comando, instalarás dependencias como el stack LAMP (Linux, Apache, MySQL/MariaDB y PHP), Composer como gestor de paquetes de PHP, Git y GraphicsMagick para el procesamiento automático de imágenes.

sudo apt install apache2 mariadb-server composer graphicsmagick php php-common php-mysql libapache2-mod-php php-gd php-curl php-json php-xmlrpc php-intl php-gmagick php-bcmath php-zip php-apcu php-mbstring php-fileinfo php-xml php-soap

Escribe Y para continuar con la instalación.

Cuando la instalación esté completa, verifica el estado de los servicios de Apache y MariaDB, y luego verifica las versiones de PHP, Composer y GraphicsMagick.

Verifica el estado del servicio de Apache con el siguiente comando. Deberías obtener la salida del servicio de Apache como ‘ enabled ‘ y ‘active (running)’.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

A continuación, verifica el estado del servicio de MariaDB utilizando el siguiente comando. La salida debería ser similar a la de Apache, verás que el servidor MariaDB está ‘ enabled ‘ y ‘ active (running) ‘.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Ahora ejecuta el siguiente comando para verificar las versiones de PHP y Composer. En Ubuntu 24.04, la versión predeterminada de PHP es 8.3, y la de Composer es 2.7.1.

php -v  
sudo -u www-data composer --version

Por último, verifica la versión de GraphicsMagick usando el siguiente comando. Deberías ver GraphicsMagick 1.3 instalado en tu sistema Ubuntu.

gm version

Configurando PHP

Para instalar TYPO3, debes cambiar el archivo de configuración PHP predeterminado ‘php.ini’. Necesitas editar el archivo ‘php.ini’ tanto para Apache como para PHP CLI, y luego cambiar algunas configuraciones predeterminadas para la instalación de TYPO3.

Edita el archivo ‘php.ini’ tanto para Apache como para PHP CLI con el siguiente comando del editor nano.

sudo nano /etc/php/8.3/apache2/php.ini  
sudo nano /etc/php/8.3/cli/php.ini

Cambia la configuración predeterminada con lo siguiente. Asegúrate de ajustar las opciones ‘ memory_limit ‘ y ‘ date.timezone ‘ según tu entorno de servidor.

date.timezone = Europe/Amsterdam  
memory_limit = 512M  
max_execution_time = 240  
max_input_vars = 1500  
post_max_size = 50M  
upload_max_filesize = 50M

Guarda el archivo y sal.

Ahora ejecuta el siguiente comando para reiniciar el servicio de Apache y aplicar tus cambios en PHP.

sudo systemctl restart apache2

Después de eso, ejecuta el siguiente comando para crear un nuevo archivo ‘info.php’ en el directorio ‘ /var/www/html ‘.

echo "" > /var/www/html/info.php

Por último, visita http://192.168.5.30/info.php usando tu navegador web preferido. Verás detalles de tus configuraciones de PHP, asegúrate de que todo lo que has configurado a través de ‘ php.ini ‘ se haya aplicado.

Ve a la sección ‘Core’ para ver el ‘ memory_limit ‘, ‘ post_max_size ‘, ‘ max_execution_time ‘, y otros de tu instalación de PHP.

Configurando el servidor MariaDB

Ahora que has configurado PHP, necesitas asegurar el servidor MariaDB, y luego crear una nueva base de datos y usuario para TYPO3. En esta sección, asegurarás MariaDB utilizando la utilidad ‘ mariadb-secure-installation ‘ y crearás una nueva base de datos y usuario desde la línea de comandos.

Asegura tu instalación del servidor MariaDB ejecutando el comando ‘ mariadb-secure-installation ‘ a continuación.

sudo mariadb-secure-installation

Ahora, se te pedirá que configures el servidor MariaDB. Ingresa Y para aceptar la configuración predeterminada o n para rechazarla.

• La instalación predeterminada de MariaDB viene sin contraseña, presiona ENTER cuando se te pida la contraseña.
• Ahora ingresa Y para configurar la contraseña de root de MariaDB. Luego, escribe la nueva contraseña para MariaDB y repite la contraseña.
• Ingresa Y para eliminar el usuario anónimo de tu instalación de MariaDB.
• Ingresa Y nuevamente cuando se te pida deshabilitar el inicio de sesión remoto para el usuario root de MariaDB.
• Ingresa Y para eliminar la base de datos de prueba predeterminada de tu MariaDB.
• Por último, ingresa Y para recargar los privilegios de las tablas y aplicar los nuevos cambios.

Después de haber configurado el servidor MariaDB, inicia sesión en MariaDB con el siguiente comando. Ingresa tu contraseña de root de MariaDB cuando se te pida.

sudo mariadb -u root -p

Ahora ejecuta las siguientes consultas para crear una nueva base de datos, ‘typo3db’, y un nuevo usuario, ‘typo3’, con la contraseña ‘Typo3Password’. Cambia la información de la base de datos según sea necesario.

CREATE DATABASE typo3db;  
GRANT ALL PRIVILEGES ON typo3db.* to typo3@localhost IDENTIFIED BY 'Typo3Password';  
FLUSH PRIVILEGES;

A continuación, ejecuta la consulta a continuación para verificar los privilegios del usuario ‘ typo3 ‘. Esto asegurará que el usuario ‘ typo3 ‘ pueda acceder a la base de datos ‘ typo3db ‘ para tu instalación de TYPO3 CMS.

SHOW GRANTS FOR typo3@localhost;

La salida a continuación te muestra que el usuario ‘ typo3 ‘ puede acceder a la base de datos ‘ typo3db ‘.

Por último, escribe quit para salir del servidor MariaDB.

Descargando TYPO3 a través de Composer

Hay múltiples formas de instalar y descargar el código fuente de TYPO3. Ahora configurarás el directorio de instalación de TYPO3, y luego descargarás TYPO3 usando Composer (gestión de dependencias de PHP).

Primero, ejecuta el siguiente comando para crear nuevos directorios para la caché y configuración de Composer, y el directorio de instalación de TYPO3 ‘ /var/www/typo3 ‘.

sudo mkdir -p /var/www/{.cache,.config,typo3}

Ahora ejecuta el comando a continuación para cambiar la propiedad de los directorios anteriores al usuario ‘ www-data ‘, y luego habilitar el acceso de lectura y escritura al directorio ‘/var/www/typo3 ‘.

sudo chown -R www-data:www-data /var/www/{.cache,.config,typo3}  
sudo chmod u+rw /var/www/typo3

A continuación, ve al directorio ‘ /var/www/typo3 ‘ e instala TYPO3 CMS con el comando ‘ composer ‘ a continuación. En este ejemplo, instalarás la última versión de TYPO3 CMS v12 en tu servidor Ubuntu.

cd /var/www/typo3  
sudo -u www-data composer create-project typo3/cms-base-distribution:^12 .

Puedes ver a continuación el proceso de descarga e instalación de TYPO3 CMS:

Configurando TYPO3 a través de la línea de comandos

Después de descargar el código fuente de TYPO3 CMS, configurarás la instalación de TYPO3 usando la línea de comandos. También puedes configurar la instalación de TYPO3 usando un navegador web, pero ahora estarás configurando la instalación de TYPO3 CMS desde tu terminal.

Para configurar la instalación de TYPO3 CMS a través del comando, ejecuta lo siguiente:

./vendor/bin/typo3 setup

Se te pedirá que realices las siguientes configuraciones:

• Escribe apache como el servidor web.
• Escribe mysqli como el controlador de base de datos.
• Ingresa los detalles de tu usuario de MariaDB, contraseña, puerto y host que se utilizarán para TYPO3 CMS.
• Escribe typo3db como el nombre de la base de datos.
• Escribe tu usuario administrador, contraseña y dirección de correo electrónico para TYPO3 CMS. Tu contraseña debe contener al menos un carácter especial.
• Para el nombre del proyecto, déjalo como predeterminado.
• Presiona ENTER cuando se te pida crear el sitio básico.

Si tu instalación es exitosa, verás una salida ‘ ¡Felicidades! - La configuración de TYPO3 está completa ‘.

Por último, vuelve a ejecutar el siguiente comando para cambiar la propiedad del directorio ‘ /var/www/typo3 ‘ al usuario ‘ www-data ‘.

sudo chown -R www-data:www-data /var/www/typo3

Configurando el host virtual de Apache

Ahora que has configurado TYPO3 desde la terminal, pasemos a configurar el host virtual de Apache para tu instalación de TYPO3. Asegúrate de haber preparado tu nombre de dominio.

Primero, activa el módulo ‘ rewrite ‘ de Apache con el siguiente comando.

sudo a2enmod rewrite

Luego crea un nuevo archivo de host virtual ‘ /etc/apache2/sites-available/typo3.conf ‘ usando el siguiente comando del editor nano.

sudo nano /etc/apache2/sites-available/typo3.conf

Inserta la siguiente configuración y asegúrate de cambiar la opción ServerName con tu nombre de dominio de TYPO3 CMS. En este ejemplo, TYPO3 CMS se ejecutará en el dominio ‘ howtoforge.local ‘.

  
 ServerAdmin [email protected]  
 DocumentRoot /var/www/typo3/public  
 ServerName howtoforge.local  
  
   
 Options FollowSymlinks  
 AllowOverride All  
 Require all granted  
   
  
 ErrorLog ${APACHE_LOG_DIR}/error.log  
 CustomLog ${APACHE_LOG_DIR}/access.log combined  
  
   
 RewriteEngine on  
 RewriteBase /  
 RewriteCond %{REQUEST_FILENAME} !-f  
 RewriteRule ^(.*) index.php [PT,L]  
   

Ahora ejecuta el siguiente comando para activar el archivo de host virtual ‘typo3.conf’ y verificar la sintaxis de tu Apache. La salida ‘ Syntax OK ‘ se mostrará, si tienes la sintaxis de Apache correcta.

sudo a2ensite typo3.conf  
sudo apachectl configtest

Por último, reinicia el servicio de Apache con el siguiente comando para aplicar tu host virtual de TYPO3 CMS. Cuando se ejecute, tu instalación de TYPO3 CMS estará lista.

sudo systemctl restart apache2

Asegurando TYPO3 CMS con HTTPS

En esta sección, asegurarás TYPO3 CMS con HTTPS utilizando Certbot y Letsencrypt. Certbot se utilizará para generar certificados SSL/TLS de Letsencrypt. Además, utilizarás el complemento Certbot Apache para configurar HTTPS automático en tus hosts virtuales.

Instala Certbot y el complemento Certbot Apache con el siguiente comando. Escribe Y para continuar con la instalación.

sudo apt install certbot python3-certbot-apache

Después de la instalación, ejecuta el comando ‘certbot’ a continuación para generar certificados SSL/TLS para tu nombre de dominio de TYPO3 CMS. Asegúrate de cambiar el nombre de dominio y la dirección de correo electrónico por tu información.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d howtoforge.local

Cuando el proceso termine, tu TYPO3 CMS estará asegurado con HTTPS automáticamente. Tus certificados SSL/TLS están disponibles en el directorio ‘ /etc/letsencrypt/live/domain.com ‘.

Accediendo a TYPO3

Visita la página de inicio de sesión de TYPO3 CMS en https://howtoforge.local/typo3 usando tu navegador web preferido. Si tu instalación es exitosa, deberías obtener la página de inicio de sesión de TYPO3 CMS.

Ingresa tu usuario y contraseña de administrador, luego haz clic en Login para confirmar.

Después de iniciar sesión, verás el panel de administración de TYPO3 CMS como el siguiente:

En el menú superior derecho, haz clic en el ícono de información para obtener detalles sobre tu stack de TYPO3 CMS. Como puedes ver a continuación, TYPO3 CMS 12.4 está instalado con Apache 2.4.58, servidor MariaDB 10.11, PHP 8.3, y el modo Composer está habilitado.

Conclusión

¡Felicidades! Has instalado TYPO3 CMS en el servidor Ubuntu 24.04. Tienes TYPO3 CMS funcionando con el LAMP Stack (Linux, Apache, MySQL/MariaDB y PHP), procesamiento de imágenes con GraphicsMagick, y el modo Composer habilitado. También aseguraste TYPO3 CMS con HTTPS utilizando Certbot y Letsencrypt.