Cómo instalar TYPO3 CMS en Ubuntu 24.04

TYPO3 es un sistema de gestión de contenidos de nivel empresarial, gratuito y de código abierto. Ofrece funciones de nivel empresarial, como un CMS escalable con soporte multisitio, instalaciones multilingües, una sólida implementación de seguridad, una velocidad vertiginosa y puede ejecutarse en cualquier lugar.

El uso de TYPO3 CMS te permite crear sitios web flexibles y fiables. El CMS TYPO3 está respaldado por una vibrante comunidad profesional. Por su diseño, el TYPO3 CMS es un sistema de gestión de contenidos enchufable con una arquitectura adaptable y desacoplada.

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

Requisitos previos

Para empezar con esta guía, asegúrate de que tienes 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.

Instalación de dependencias

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

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

sudo apt update

Ahora instala las dependencias de paquetes para TYPO3 CMS con el siguiente comando ‘apt install’. Con este comando, instalarás dependencias como la Pila LAMP (Linux, Apache, MySQL/MariaDB y PHP), Composer como gestor de paquetes 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 proceder a la instalación.

Una vez finalizada la instalación, comprueba el estado de los servicios Apache y MariaDB y, a continuación, comprueba las versiones de PHP, Composer y GraphicsMagick.

Comprueba el estado del servicio Apache con el comando que se indica a continuación. Deberías obtener la salida del servicio Apache como«habilitado» y «activo (en ejecución)».

sudo systemctl is-enabled apache2
sudo systemctl status apache2

A continuación, comprueba el estado del servicio MariaDB con el siguiente comando. La salida debería ser similar a la de Apache, verás que el servidor MariaDB está ‘habilitado‘ y ‘activo (ejecutándose)‘.

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

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

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

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

gm version

Configurar PHP

Para instalar TYPO3, debes cambiar el archivo de configuración por defecto de PHP ‘php.ini’. Tienes que editar el archivo ‘php.ini’ tanto para Apache como para PHP CLI, y luego cambiar algunas configuraciones por defecto 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 por defecto con lo siguiente. Asegúrate de ajustar las opciones‘memory_limit‘ y‘date.timezone‘ con el entorno de tu 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 Apache y aplicar tus cambios en PHP.

sudo systemctl restart apache2

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

echo "<?php phpinfo(); ?>" > /var/www/html/info.php

Por último, visita http://192.168.5.30/info.php utilizando tu navegador web preferido. Verás los detalles de tus configuraciones PHP, asegúrate de que se aplica todo lo que has configurado mediante‘php.ini‘.

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

Configurar el servidor MariaDB

Ahora que has configurado PHP, necesitas asegurar el servidor MariaDB, y luego crear una nueva base de datos y un nuevo 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 un nuevo usuario desde la línea de comandos.

Asegura la instalación de tu servidor MariaDB ejecutando el comando «mariadb-secure-installation» que se indica a continuación.

sudo mariadb-secure-installation

Ahora se te pedirá que configures el servidor MariaDB. Introduce Y para aceptar la configuración por defecto o n para rechazarla.

• La instalación por defecto de MariaDB viene sin contraseña, pulsa ENTER cuando se te pida la contraseña.
• Ahora introduce Y para configurar la contraseña raíz de MariaDB. A continuación, escribe la nueva contraseña para MariaDB y repite la contraseña.
• Introduce Y para eliminar el usuario anónimo de tu instalación de MariaDB.
• Vuelve a introducir Y cuando se te pida para desactivar el inicio de sesión remoto para el usuario raíz de MariaDB.
• Introduce Y para eliminar la prueba de base de datos por defecto de tu MariaDB.
• Por último, introduce Y para recargar los privilegios de las tablas y aplicar los nuevos cambios.

Cuando hayas configurado el servidor MariaDB, inicia sesión en MariaDB con el siguiente comando. Introduce tu contraseña de root de MariaDB cuando te lo 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 los detalles de la información de la base de datos según necesites.

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

A continuación, ejecuta la siguiente consulta para comprobar los privilegios del usuario ‘typo3‘. Así te asegurarás de que el usuario ‘typo3‘ puede acceder a la base de datos‘typo3db‘ de tu instalación de TYPO3 CMS.

SHOW GRANTS FOR typo3@localhost;

El siguiente resultado muestra que el usuario «typo3» puede acceder a la base de datos«typo3db«.

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

Descarga de TYPO3 a través de Composer

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

En primer lugar, ejecuta el siguiente comando para crear nuevos directorios para la caché y la 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 siguiente comando para cambiar la propiedad de los directorios anteriores al usuario‘www-data‘, y luego habilita 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‘ que aparece 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 .

A continuación puedes ver el proceso de descarga e instalación de TYPO3 CMS:

Instalación de 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 mediante la línea de comandos. También puedes configurar la instalación de TYPO3 mediante un navegador web, pero ahora configurarás la instalación de TYPO3 CMS desde tu terminal.

Para configurar la instalación de TYPO3 CMS mediante un comando, ejecuta lo siguiente:

./vendor/bin/typo3 setup

Se te pedirán las siguientes configuraciones:

• Escribe apache como servidor web.
• Escribe mysqli como controlador de la base de datos.
• Introduce los datos de tu usuario, contraseña, puerto y host de MariaDB que se utilizará para TYPO3 CMS.
• Escribe typo3db como nombre de la base de datos.
• Introduce 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 por defecto.
• Pulsa INTRO cuando se te pida crear el sitio básico.

Si la instalación se ha realizado correctamente, apareceráel mensaje «Enhorabuena, la instalación de TYPO3 ha finalizado«.

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

Configurar el host virtual Apache

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

En primer lugar, activa el módulo‘rewrite’ de Apache con el siguiente comando.

sudo a2enmod rewrite

A continuación, crea un nuevo archivo de host virtual‘/etc/apache2/sites-available/typo3.conf‘ utilizando el siguiente comando del editor nano.

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

Introduce la siguiente configuración y asegúrate de cambiar la opción ServerName por el nombre de dominio de tu TYPO3 CMS. En este ejemplo, TYPO3 CMS se ejecutará en el dominio‘hwdomain.io‘.

<VirtualHost *:80>
 ServerAdmin [email protected]
 DocumentRoot /var/www/typo3/public
 ServerName hwdomain.io
<Directory /var/www/typo3/public/>
Options FollowSymlinks
AllowOverride All
Require all granted
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined

<Directory /var/www/typo3/public/>
RewriteEngine on
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*) index.php [PT,L]
</Directory>
</VirtualHost>

Ahora ejecuta el siguiente comando para activar el archivo de host virtual ‘typo3.conf’ y verificar la sintaxis de Apache. Si la sintaxis de Apache es correcta, aparecerá el mensaje«Sintaxis correcta«.

sudo a2ensite typo3.conf
sudo apachectl configtest

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

sudo systemctl restart apache2

Asegurar 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 desde Letsencrypt. Además, utilizarás el plugin Certbot Apache para configurar HTTPS automático en tus hosts virtuales.

Instala Certbot y el plugin Certbot APache con el siguiente comando. Escribe Y para proceder a la instalación.

sudo apt install certbot python3-certbot-apache

Tras la instalación, ejecuta el comando ‘certbot’ que aparece a continuación para generar certificados SSL/TLS para tu nombre de dominio TYPO3 CMS. Así que asegúrate de cambiar el nombre de dominio y la dirección de correo electrónico con tu información.

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

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

Acceder a TYPO3

Visita la página de inicio de sesión de TYPO3 CMS en https://hwdomain.io/typo3 utilizando tu navegador web preferido. Si la instalación se ha realizado correctamente, deberías acceder a la página de inicio de sesión de TYPO3 CMS.

Introduce tu usuario y contraseña de administrador, y haz clic en Iniciar sesión 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 icono de información para obtener detalles sobre tu pila TYPO3 CMS. Como puedes ver a continuación, el TYPO3 CMS 12.4 está instalado con Apache 2.4.58, MariaDB server 10.11, PHP 8.3, y el modo Compositor está activado.

Conclusión

¡Enhorabuena! Has instalado TYPO3 CMS en el servidor Ubuntu 24.04. Tienes TYPO3 CMS funcionando con la pila LAMP (Linux, Apache, MySQL/MariaDB y PHP), el procesamiento de imágenes GraphicsMagick y el modo Compositor activado. También has asegurado TYPO3 CMS con HTTPS utilizando Certbot y Letsencrypt.