Instalar TYPO3 en tu hosting: guía completa

TYPO3 es un sistema de gestión de contenidos empresarial muy adecuado para páginas web y portales complejos. En esta guía aprenderás a instalar TYPO3 con Composer en el hosting compartido de Theory7.

Por qué elegir TYPO3

TYPO3 destaca por:

  • Escalabilidad de nivel empresarial
  • Amplio soporte multilingüe
  • Gestión avanzada de permisos
  • Comunidad sólida en los Países Bajos y en Europa
  • Soporte a largo plazo (LTS)
  • Excelente seguridad TYPO3 lo utilizan administraciones públicas, universidades y grandes empresas.

Requisitos del sistema

Comprueba que tu hosting cumple los requisitos.

Requisitos de PHP

TYPO3 13 requiere:

  • PHP 8.2, 8.3 o 8.4
  • Extensiones necesarias:
    • gd o ImageMagick
    • curl
    • zip
    • xml
    • mbstring
    • json
    • session

Requisitos de la base de datos

  • MySQL 8.0 o superior
  • MariaDB 10.3 o superior
  • PostgreSQL 10 o superior (alternativa)

Requisitos del servidor

  • Mínimo 256MB de memoria PHP (se recomiendan 512MB o más)
  • mod_rewrite para URL limpias
  • Composer para la instalación
  • Acceso SSH En el hosting de Theory7, todos los requisitos están disponibles de serie.

Activar el acceso SSH

Para instalar TYPO3 necesitas SSH.

Configurar SSH

  1. Inicia sesión en DirectAdmin
  2. Ve a Account Manager y después a SSH Keys
  3. Genera o sube tu clave SSH
  4. Activa el acceso SSH Consulta también: Activar el acceso SSH

Establecer la conexión

ssh gebruikersnaam@example.nl

Instalar TYPO3 con Composer

El método de instalación recomendado.

Crear el proyecto

# Ve a la carpeta de tu dominio
cd ~/domains/example.nl
# Crea un nuevo proyecto TYPO3
composer create-project typo3/cms-base-distribution myproject
# Esto crea una carpeta 'myproject' con TYPO3

Verificar la instalación

cd myproject
ls -la
# Verás: public/, var/, vendor/, composer.json, etc.

Configurar la raíz de documentos

La carpeta public de TYPO3 debe ser la raíz web.

Método del enlace simbólico (recomendado)

cd ~/domains/example.nl
# Copia de seguridad de la carpeta public_html existente
mv public_html public_html_backup
# Enlace simbólico a la carpeta public de TYPO3
ln -s myproject/public public_html

Alternativa en DirectAdmin

  1. Ve a DirectAdmin
  2. Abre Domain Setup
  3. Cambia la raíz de documentos a myproject/public

Crear la base de datos

TYPO3 necesita una base de datos.

Crear la base de datos en DirectAdmin

  1. Ve a Account Manager y después a MySQL Management
  2. Haz clic en Create new Database
  3. Rellena:
    • Nombre de la base de datos
    • Nombre de usuario
    • Contraseña segura
  4. Anota todos los datos para el asistente de instalación

Completar el asistente de instalación

Ahora puedes iniciar la instalación desde el navegador.

Abrir el asistente

  1. Abre tu navegador
  2. Ve a https://example.nl
  3. Se te redirigirá al asistente de instalación

Paso 1: Comprobación del sistema

El asistente comprueba automáticamente:

  • Versión de PHP
  • Extensiones necesarias
  • Permisos de archivos
  • Límite de memoria Resuelve los posibles problemas antes de continuar.

Paso 2: Configurar la base de datos

Introduce los datos de la base de datos:

  • Database host: localhost
  • Database port: 3306
  • Database name: tu_base_de_datos
  • Database username: tu_usuario
  • Database password: tu_contraseña Haz clic en Continue.

Paso 3: Datos iniciales

Elige qué quieres instalar:

  • Empezar en blanco: sin contenido preconfigurado
  • Introduction Package: sitio de demostración con ejemplos Para una web nueva, lo normal es empezar en blanco.

Paso 4: Crear el administrador

Crea la cuenta de administrador:

  • Username: elige un nombre seguro (no "admin")
  • Password: mínimo 12 caracteres, segura
  • Email: tu dirección de correo electrónico

Paso 5: Completar la instalación

TYPO3 configura ahora la base de datos y el sistema. Esto puede tardar unos minutos.

Configurar el backend

Tras la instalación, puedes configurar el backend.

Abrir el backend

  1. Ve a https://example.nl/typo3
  2. Inicia sesión con tus datos de administrador
  3. Accederás al backend de TYPO3

Primera configuración

  1. Ve a Settings en la navegación de la izquierda
  2. Haz clic en Configure Installation-Wide Options
  3. Comprueba y ajusta:
    • Nombre del sitio
    • Idioma predeterminado
    • Ajustes de correo

Configuración del sitio

  1. Ve a Sites
  2. Haz clic en + Create new site configuration
  3. Configura:
    • URL base
    • Ajustes de idioma
    • Gestión de errores

Instalar extensiones

TYPO3 se puede ampliar con extensiones.

Con Extension Manager

  1. Ve a Admin Tools y después a Extensions
  2. Busca la extensión que quieras
  3. Haz clic en el icono de instalación
  4. Sigue el asistente de configuración si es necesario

Con Composer (recomendado)

cd ~/domains/example.nl/myproject
# Instala la extensión
composer require vendor/extension-name
# Por ejemplo:
composer require georgringer/news
composer require in2code/powermail

Después, actívala en Extension Manager.

Optimización para producción

Optimiza TYPO3 para el entorno de producción.

Configurar la caché

En el archivo config/system/settings.php, añade lo siguiente:

return [
    'SYS' => [
        'caching' => [
            'cacheConfigurations' => [
                'hash' => [
                    'backend' => 'TYPO3\\CMS\\Core\\Cache\\Backend\\FileBackend',
                ],
            ],
        ],
    ],
];

Configurar el programador de tareas

  1. Ve a Admin Tools y después a Scheduler
  2. Configura tareas como la limpieza de la caché
  3. Configura la tarea cron en DirectAdmin:
*/15* * * * cd /path/to/myproject && vendor/bin/typo3 scheduler:run

Problemas frecuentes

El asistente de instalación no aparece

  1. Comprueba la raíz de documentos
  2. Comprueba que existe public/index.php
  3. Revisa los registros de errores

Errores Permission denied

chmod -R 775 var
chmod -R 775 public/typo3temp
chmod -R 775 public/fileadmin

Database connection failed

  1. Comprueba los datos de la base de datos
  2. Prueba la conexión con phpMyAdmin
  3. Comprueba que la base de datos existe

Buenas prácticas de seguridad

Protege tu instalación de TYPO3:

  1. Usa contraseñas de administrador seguras
  2. Limita las direcciones IP del backend si es posible
  3. Mantén TYPO3 y las extensiones actualizados
  4. Configura HTTPS
  5. Haz copias de seguridad con regularidad