Saltar al contenido principal
Cada aplicación publicada responde en un subdominio *.vertraweb.app. Los dominios personalizados permiten que la misma aplicación responda en direcciones que tú controlas, como api.tuempresa.com, con un certificado HTTPS que la plataforma emite y renueva por ti. Añadir, cambiar o quitar un dominio nunca reinicia la aplicación.

​
Antes de empezar

La aplicación está publicada en la web (plan Pro o superior, con al menos 512 MB de RAM).
Tu cuenta está en el plan Intermediary o superior. El número de dominios por aplicación aumenta con el plan; consulta Límites.
Puedes editar los registros DNS del dominio en tu registrador o en tu proveedor de DNS.

​
Añadir un dominio

1

Añade el dominio en el panel

Abre la aplicación, ve a Red y, en Dominios, elige Añadir dominio. Escribe el nombre de host, por ejemplo example.com o api.example.com. Deja activada la opción Incluir también www si quieres el complemento automático descrito más abajo.
2

Crea los registros DNS

Abre Registros DNS en el dominio. Crea cada registro en tu proveedor de DNS exactamente como se muestra. La tabla incluye un CNAME que apunta el nombre de host a Vertra Cloud, y normalmente un registro de validación para el certificado.Antes, elimina cualquier registro A, AAAA o CNAME existente con el mismo nombre: tener dos registros para un mismo nombre es la causa más común de que un dominio nunca se valide.
3

Espera al DNS y al certificado

La mayoría de los proveedores propagan los cambios en minutos; en el peor de los casos, tarda 48 horas. Cuando los registros se resuelven, la plataforma valida el dominio y emite el certificado SSL automáticamente. HTTP se redirige a HTTPS.
4

Compruébalo

El primer comando debe mostrar la dirección de destino; el segundo debe responder con el código de estado de tu aplicación.
El mismo flujo está disponible en la API, en la CLI (vertra app domains) y en el servidor MCP.

​
Dominio raíz y www

Cuando añades un dominio raíz (example.com), la plataforma añade también www.example.com, y cuando añades www.example.com, añade también el raíz. Este complemento automático redirige al dominio que añadiste mediante una redirección permanente (308), así que ambas direcciones funcionan y solo una es la canónica. El complemento no cuenta para el límite de dominios de tu plan y se elimina junto con el dominio principal. Desactiva Incluir también www ("www": false en la API) para añadir solo el nombre de host que escribiste. Otros subdominios, como app.example.com, no tienen complemento. Para cambiar cuál es el dominio principal, abre el menú del complemento y elige Hacer principal. Entonces pasa a servir la aplicación, y el antiguo dominio principal redirige a él.
Un registro CNAME en el dominio raíz solo funciona en proveedores de DNS que admitan CNAME flattening, ALIAS o ANAME. El estándar de DNS no permite un CNAME en la raíz, y muchos registradores no ofrecen una alternativa. El panel te avisa cuando un dominio es raíz. Si tu proveedor no puede hacerlo, añade www.example.com con el complemento desactivado y apunta solo ese nombre.

​
Puerto, prefijo de ruta y redirección

Abre Opciones avanzadas al añadir un dominio, o Editar en uno existente. Las tres opciones se aplican de inmediato, sin reiniciar.
Por defecto, un dominio llega a tu aplicación por el puerto 80. Un dominio puede apuntar a cualquier puerto entre 1 y 65535, así que una misma aplicación puede servir un sitio en un dominio y una API en otro. Una aplicación puede usar hasta 5 puertos además del 80 entre sus dominios; la plataforma responde DOMAIN_PORT_LIMIT_REACHED si se supera ese número. Tu aplicación debe escuchar en el puerto que elijas, en 0.0.0.0, además del puerto 80, que su dirección *.vertraweb.app sigue usando.
Una ruta literal que se antepone a cada petición que llega al dominio. Con /api, una petición a https://api.example.com/users llega a tu aplicación como /api/users. Empieza por /, no termina en / y solo acepta letras, dígitos y . _ ~ -.Recomendado para APIs. Un sitio web tiene que funcionar bajo esa ruta: sus archivos estáticos y sus propias redirecciones deben respetarla.
Envía cada petición de este dominio a otro dominio de la misma aplicación, manteniendo la ruta y la cadena de consulta. Elige el código de estado: 301 u 308 (permanentes), 302 o 307 (temporales). 307 y 308 mantienen el método de la petición; 301 y 302 pueden convertir un POST en un GET. El valor por defecto es 308. Una redirección no puede apuntar a otra redirección, y el dominio de destino debe estar activo.

​
Estado y SSL

Cada dominio muestra un estado y un estado del certificado. Los estados se actualizan en segundo plano y cada vez que abres Registros DNS.
Un dominio que permanece en pending, moved o deleted durante 14 días se elimina automáticamente, y te avisamos por correo electrónico. No hay ningún aviso previo, así que revisa los dominios que no hayan pasado a active. Corrige los registros DNS o elimina el dominio tú mismo. Después de la eliminación automática, borra los registros DNS que creaste.

​
Eliminar un dominio

Abre el menú del dominio en Red y elige Quitar, o llama a Eliminar dominio de la aplicación. El dominio deja de responder de inmediato y la aplicación no se reinicia.
Quitar un dominio no cambia tu DNS. Borra el CNAME y los registros TXT de validación en tu proveedor de DNS, tanto del dominio como de su complemento www. Si permanecen, el nombre sigue apuntando a Vertra Cloud y otro cliente podría reclamarlo. Haz lo mismo después de dejar de publicar la aplicación y después de la eliminación automática de un dominio que estuvo 14 días sin DNS.

​
Uso de Cloudflare

Si el DNS del dominio está en Cloudflare, crea el CNAME con el proxy desactivado (nube gris, “solo DNS”) hasta que se emita el certificado. Con el proxy activado, la validación ve las direcciones de Cloudflare en lugar de tu registro. Cuando HTTPS funcione, puedes activar el proxy; en ese caso, configura el modo SSL en Full (strict), ya que la aplicación ya sirve un certificado válido. El modo Flexible provoca un bucle de redirecciones, porque la plataforma redirige HTTP a HTTPS.

​
Límites

Los dominios personalizados empiezan en el plan Intermediary. Dominios por aplicación, sin contar el complemento automático: Hasta 5 puertos distintos además del 80 por aplicación, en todos los planes que tienen dominios. Planes y límites es la referencia.

​
Solución de problemas

Ejecuta dig +short app.example.com. Si no hay respuesta, el registro todavía no existe o tiene una errata; si en lugar del destino aparece una dirección IP, queda un registro A antiguo o el proxy de Cloudflare está activado.
El certificado solo se emite después de validar el DNS. Espera unos minutos después de que se resuelvan los registros y recarga la página. Si persiste, elimina el dominio y vuelve a añadirlo en Red.
Estás detrás de un proxy en modo SSL Flexible. Cámbialo a Full (strict).
El dominio está bien; la aplicación no está escuchando. Debe escuchar en 0.0.0.0 y en el puerto configurado para ese dominio (80 por defecto; consulta PORT en Configuración).
DOMAIN_LIMIT_REACHED significa que la aplicación ya tiene tantos dominios como permite el plan. DOMAIN_ALREADY_IN_USE significa que el nombre de host está asociado a otra aplicación. APP_NOT_PUBLISHED significa que la aplicación todavía no tiene una dirección *.vertraweb.app; publícala primero. La lista completa está en Errores.
Al dejar de publicar la aplicación se eliminan todos sus dominios personalizados junto con el subdominio, pero no tus registros DNS: bórralos. Volver a publicar significa añadir los dominios de nuevo y crear los registros que se muestran para cada uno.
Última modificación el 26 de octubre de 2026