Cloud & IaaS — Primeros pasos con Directus

Aplica a: Cloud Server con Directus instalado · Tiempo estimado: 20 min

¿Qué vas a lograr?

Instalar Directus, configurar el dominio con SSL, personalizar la aplicación, configurar el correo y reforzar la seguridad.

1. Instalación

Instalá Directus desde el catálogo Click&Go en Mi cuenta → Mis Servicios → Cloud & IaaS → Gestionar
Andá a Software y accesos, buscá la imagen Directus en el catálogo y presioná Siguiente
Elegí el método de autenticación y hacé clic en Siguiente
Revisá la información y hacé clic en Confirmar e instalar
La imagen Click&Go crea automáticamente tres contenedores Docker: Redis (caché), PostgreSQL (base de datos con volumen persistente) y Directus (última versión estable, con volumen para archivos subidos). También incluye Nginx para acceso por dominio propio con SSL.

Los archivos de configuración están en /root/app:
- docker-compose.yml — orquesta los contenedores
- .env — configuración de la aplicación
- app-nginx.conf — configuración de Nginx
Cualquier modificación en .env o docker-compose.yml requiere ejecutar:
```
docker compose up -d
```

2. Configurar el dominio y SSL

El dominio debe apuntar a la IP del servidor antes de continuar.

En Software y accesos, hacé clic en Configurar Dominio y SSL
Ingresá el dominio o subdominio y seguí las instrucciones
Una vez configurado, podés acceder al administrador en https://tudominio.com/admin

3. Personalizar la aplicación

Desde la sección Ajustes del panel de administración podés configurar el nombre, descripción, URL e idioma del proyecto

En la sección Apariencia podés ajustar colores, logo y otros aspectos visuales

Para más opciones consultá la documentación oficial de Directus.

4. Configurar el servidor SMTP

Por defecto Directus usa sendmail desde [email protected], lo que puede resultar en correos enviados a spam. Para usar un servidor SMTP externo, editá /root/app/.env y agregá:

EMAIL_FROM=
EMAIL_VERIFY_SETUP=
EMAIL_TRANSPORT=smtp
EMAIL_SMTP_HOST=
EMAIL_SMTP_PORT=
EMAIL_SMTP_USER=
EMAIL_SMTP_PASSWORD=
EMAIL_SMTP_SECURE=false #false to use TLS
#EMAIL_SMTP_IGNORE_TLS=

Después de editar el archivo:

docker compose up -d

5. Seguridad

Políticas de contraseñas — en Ajustes, activá el requerimiento de seguridad Fuerte para contraseñas.

Intentos de inicio de sesión — en Ajustes, limitá los intentos fallidos antes del bloqueo. El valor por defecto es 25; se recomienda bajarlo a 4 o 5.

Deshabilitar redirección al admin — por defecto, visitar https://tudominio.com redirige a /admin. Para evitarlo, agregá en .env:

ROOT_REDIRECT=false

También podés configurar ROOT_REDIRECT con una URL específica para redirigir a los visitantes a otra página. Aplicá los cambios con docker compose up -d.

Rate Limiting — antes de pasar a producción, configurá límites de solicitudes en el archivo .env.

6. Websockets (Directus Realtime)

Directus Realtime no está habilitado por defecto. Para activarlo:

Editá /root/app/.env y verificá que WEBSOCKETS_ENABLED=true
Para editar ese archivo utiliza ese siguiente comando:
```
nano /root/app/.env
```
Reiniciá Directus:
```
docker compose up -d
```
Verificá que la configuración de Nginx soporte websockets editando /etc/nginx/sites-available/app.conf:
```
nano /etc/nginx/sites-available/app.conf
```
Reiniciá Nginx para aplicar los cambios:
```
systemctl restart nginx
```

Ver también

→ Cloud & IaaS — Primeros pasos con Docker

→ Cloud & IaaS — Apuntar un dominio al Cloud Server o Servidor Dedicado

→ Cloud & IaaS — Conectarse por SSH desde Windows