Guías

Dominios propios

Cada app está disponible por HTTPS en cuanto está activa. Añadir tu propio hostname es una sola llamada, pero antes conviene conocer una limitación importante.

El hostname que tienes gratis

Codara asigna a cada app un hostname gestionado al crearla y empieza a emitir su certificado. No tienes que configurar DNS; la página de la app te indica cuándo están listos el enrutamiento y el TLS.

https://<managed-label>-<workspace>.codara.cloud

Cuando un entorno contiene un solo servicio, la URL usa el nombre del proyecto en lugar del nombre de la app, que se lee mejor en el caso habitual de un único servicio. Las apps creadas antes de mediados de 2026 pueden seguir con el esquema antiguo *.apps.codarasolutions.com; puedes migrarlas al actual desde los ajustes de dominio de la app.

El hostname exacto siempre aparece en la página de la app, o con:

bash

$ codaracloud domains list my-api$ codaracloud open my-api

Renombrar un espacio de trabajo rompe al instante sus URL generadas

La dirección del espacio de trabajo forma parte de todos los hostnames generados. Si lo renombras, esos hostnames cambian y las URL antiguas dejan de funcionar en ese momento, sin redirección. Considera permanente la dirección de un espacio de trabajo en cuanto algo real apunte a ella.

Registrar un dominio para tu organización

Si vas a usar un dominio en varias apps, regístralo una sola vez en Cuenta y organización → Dominios. Codara te da un único registro TXT para el dominio (por ejemplo, _codara-verify.acme.com). Cuando se encuentra ese registro, cualquier hostname del dominio o que cuelgue de él, como api.acme.com o staging.eu.acme.com, se puede añadir a cualquier app de la organización sin verificar cada hostname por separado. Solo los propietarios y administradores pueden registrar o quitar dominios; todos los miembros pueden verlos. Un dominio verificado se vuelve a comprobar en segundo plano más o menos una vez al día, así que si cambia de manos deja de considerarse de confianza.

Los hostnames codara.cloud incluidos no necesitan ningún registro: cada app recibe uno automáticamente.

Añadir tu propio dominio

Los dominios externos requieren dos pasos de DNS

Para un hostname fuera de codara.cloud, publica primero el registro TXT de verificación que te da Codara. Cuando se acepte el hostname, crea un CNAME que apunte a customers.codara.cloud. Después, el operador crea un Ingress dedicado y cert-manager solicita su certificado TLS.

Añade el hostname

bash

$ codaracloud domains add my-api app.acme.com

O usa la pestaña Dominios de la página de la app en la consola.

Demuestra que el dominio es tuyo

Para un dominio de tu propiedad, Codara te da un registro TXT que debes publicar antes de que se acepte el hostname:

_codara-verify.app.acme.com.   TXT   "<token Codara gives you>"

Publícalo en tu proveedor de DNS y vuelve a ejecutar el comando. Los hostnames codara.cloud generados no pasan por este proceso.

Apunta el DNS a Codara

Crea un CNAME:

app.acme.com.   CNAME   customers.codara.cloud.

En un dominio raíz (acme.com, sin subdominio), usa el registro de alias aplanado que ofrezca tu proveedor: ALIAS, ANAME o CNAME flattening. Codara acepta cualquiera de las dos formas.

Espera al certificado

Una vez que el DNS resuelve, el certificado suele emitirse en un par de minutos. El hostname no estará listo hasta que su CNAME o su alias aplanado lleguen a Codara.

Consultar el estado

La pestaña Dominios de la consola muestra en directo el estado del DNS y del certificado de cada hostname, que es justo lo que necesitas mientras esperas a que un dominio esté disponible.

La CLI no muestra el estado de los dominios

codaracloud domains list muestra los hostnames añadidos a una app, pero no su estado de DNS ni de TLS. Usa la consola para diagnosticar un dominio que no funciona. Un estado unknown suele indicar una consulta DNS lenta, no un fallo real: vuelve a comprobarlo en un momento.

Reglas

Un hostname solo puede estar en una app. Si intentas añadir uno que ya está en uso, falla y te dice qué app lo tiene.
Los hostnames gestionados deben estar exactamente un nivel por debajo de codara.cloud: api-acme.codara.cloud es válido; v2.api-acme.codara.cloud, no.
Algunos nombres están reservados de forma permanente y no se pueden reclamar.
Nunca se puede reclamar un hostname que esté dentro de la zona de otro cliente.

Quitar un dominio

bash

$ codaracloud domains remove my-api app.acme.com

Codara solo borra los registros DNS que creó. Un registro que añadiste en tu proveedor se queda ahí hasta que lo borres.

Puertos

Por defecto, el tráfico se envía al puerto 8080, y el puerto elegido se inyecta en el contenedor como PORT. Para cambiarlo:

bash

$ codaracloud apps update my-api --port 3000 --client my-workspace

Cambiar el puerto reinicia la app. Si lees PORT del entorno en lugar de fijar un valor en el código, te ahorras el problema por completo.

Dormir y despertar

Las apps pueden escalar a cero cuando están inactivas y despertarse con la siguiente petición a su dirección codara.cloud. Está desactivado por defecto: actívalo en cada app.

bash

# Sleep after 30 minutes without a request, wake on HTTP$ codaracloud apps autosleep my-api --enabled --idle-after 1800 --wake-on-http # Turn it off$ codaracloud apps autosleep my-api --disabled # Sleep or wake right now$ codaracloud apps sleep my-api$ codaracloud apps wake my-api

Cuando una app dormida recibe una petición en su dirección codara.cloud, Codara la arranca y retiene la petición unos segundos. Si arranca a tiempo, la petición se sirve con normalidad; si no, los navegadores reciben una página «waking up» que se recarga sola y los clientes de API, un 503. Cuenta con un retraso apreciable en la primera petición después de dormir.

Tres cosas que no despiertan una app

Las peticiones a un dominio propio. Despertar con una petición solo funciona en la dirección codara.cloud de la app. Los dominios propios van directos a la app, así que una app dormida con dominio propio sigue caída. Deja en Siempre activo los servicios con dominio propio.
El tráfico interno. Las llamadas entre apps no pasan por la capa que despierta, así que una dependencia privada tiene que estar siempre despierta.
Una app pausada o suspendida. Su entorno está en pausa o Codara la ha suspendido (por ejemplo, por un límite de gasto).

Solo funciona el modo por inactividad

El ajuste de autosleep acepta los modos scheduled y manual-only, pero hoy solo se aplica idle. Una app con otro modo simplemente nunca se duerme sola; dormirla y despertarla a mano sigue funcionando.

Tráfico privado entre servicios

Las apps de un mismo entorno se comunican por la red interna con CODARA_PRIVATE_URL, sin salir a internet ni ocupar un dominio. El tráfico entre entornos, proyectos o espacios de trabajo distintos está bloqueado. Consulta Conceptos básicos.

Última actualización: 26 de septiembre de 2026