Primeros pasos

Inicia sesión

Ve a cloady.com e inicia sesión con tu correo y contraseña, con Google, con GitHub o con el SSO de tu empresa. Para crear una cuenta o restablecer una contraseña, elige Create account or reset password, verifica el código que recibes por correo y define una contraseña. Las cuentas que ya tienen contraseña no necesitan un código por correo para iniciar sesión. También puedes empezar desde el campo de despliegue de cloady.com antes de iniciar sesión: configura allí la app y Deploy te pedirá que inicies sesión sin salir de la página, y después la desplegará.

El primer inicio de sesión crea tu cuenta y te pide verificar un número de teléfono: escríbelo y luego introduce el código que recibes por SMS. Es obligatorio una vez por cuenta: hasta que lo hagas, el panel te devuelve a esa pantalla y la API responde phone_required (403). Después llegas a tu primer espacio de trabajo, que Cloady crea por ti; seguirá vacío hasta que despliegues algo.

Crea un espacio de trabajo

Un espacio de trabajo reúne tus aplicaciones, tu equipo y una suscripción, en su propia dirección cloady.com/w/acme-inc. El primero ya existe. Para añadir otro, haz clic en el selector WORKSPACE de la barra superior y luego en New workspace:

1. Name: p. ej., Acme Inc. El nombre que se usa en las URL se deriva de él y se muestra en tiempo real; si ya está ocupado, verás la versión ajustada.
2. Icon · optional: haz clic en el recuadro de la cabecera de la ventana para subir uno. También define los colores del espacio de trabajo.

Un espacio de trabajo nuevo no cuesta nada y puede desplegar desde el primer momento. Lo que paga depende de lo que declaran sus apps y se cobra según cuatro planes (consulta Capacidad y precio), y todo espacio de trabajo cuyas apps quepan en 0,5 vCPU, 1 GB de RAM y 5 GB de SSD no paga nada.

Una sola suscripción cubre todas las regiones: no hay nada que activar por región.

Elige una región y un entorno

Cada app se ejecuta exactamente en una región y un entorno, que eliges al desplegarla. Los defines en la barra superior; una app nueva empieza con lo que esté seleccionado ahí, y su tarjeta te permite elegir otra región antes de desplegar.

• Región: dónde se ejecuta tu app (EE.UU. Oeste, EE.UU. Este, Alemania o Singapur). El menú muestra las regiones Deployed (en las que ya tienes apps) y las Available; al cambiar de región también se filtra el panel. Una app se queda en su región salvo que la muevas con Transfer; para ejecutar la misma app en una segunda región, despliégala también allí.
• Entorno: Production, Preview o Development. El nombre de una aplicación es único dentro de un espacio de trabajo y un entorno, así que api puede existir a la vez en producción y en preview. Las apps de desarrollo conservan una copia editable de tu código y no se redespliegan con cada push.

Algo con lo que te puedes encontrar:

• Si una región no tiene capacidad libre, el despliegue muestra Adding capacity… mientras se incorpora un servidor a la región, y después continúa por sí solo; suele tardar unos minutos. Si pasados unos 40 minutos todavía no se puede ubicar, el despliegue falla; vuelve a intentarlo.

Despliega una app

Haz clic en New application en la barra superior e indica en el campo qué quieres desplegar:

• Una plantilla: una aplicación lista para usar (WordPress, Postgres, …); escribe para buscar y haz clic en una.
• Un repositorio de GitHub: pega su URL o elige uno de tus repos. Los repos públicos funcionan directamente; para uno privado, elige antes Connect GitHub account.
• Una imagen de Docker: escribe su nombre (nginx, ghcr.io/acme/api:1.4) o un registro como docker.io/ para explorar imágenes populares.
• Una carpeta: arrástrala al campo, hasta 50 MB y 3000 archivos (se omiten node_modules, .git, .next, __pycache__ y .DS_Store). Ideal para un sitio estático ya compilado; no necesitas git.

El campo se convierte en la tarjeta de la app: arriba, lo que elegiste, su precio mensual y el botón de despliegue; debajo, los servicios que ejecuta. Abre cualquier fila de Settings para cambiarla antes de desplegar:

• Environment: rellena las variables; las plantillas indican las que necesitan y pueden generar contraseñas por ti.
• Build: si despliegas código, la rama, el directorio raíz y los comandos opcionales de build y start. Déjalos en blanco salvo que la detección se equivoque, algo que pasa en monorepos y cuando lo que hay que compilar está en una subcarpeta. Redeploy on every push está activado por defecto para los orígenes de GitHub.
• Domains: el nombre de la app, del que depende su dirección, y los dominios propios que quieras asociar.
• Resources, Region y Managed backups: los factores de escala, dónde se ejecuta y copias de seguridad diarias por el 20% del precio de la propia app.

Pulsa Enter o haz clic en Deploy. Dentro de la asignación gratuita no se cobra nada. Si la superas, se cobra el resto del mes a la tarjeta registrada; si no hay tarjeta, Deploy te pide una primero, y si la tarjeta es rechazada se devuelve payment_required (402) sin crear nada.

Cloady compila la app, configura el HTTPS por ti y la sirve en una dirección de cloady.io formada por el nombre de la app, un código corto único y el nombre del espacio de trabajo:

<app-name>-<code>-<workspace>.cloady.io

Así, una app llamada My Blog en el espacio de trabajo acme está disponible en:

my-blog-k7q2v9ze-acme.cloady.io

Todos los entornos y todas las regiones usan el mismo formato; la URL exacta está en la página de la app.

La app aparece en la cuadrícula del espacio de trabajo mientras la ventana muestra el despliegue en directo. La configuración y los secretos generados están en Settings → Environment.

Cambiar el nombre de una app

Cámbialo en Settings → General. La dirección sigue al nombre, así que el nombre de host anterior deja de responder y empieza a responder el nuevo: actualiza los enlaces, registros DNS y llamadas a la API que lo usaban. (El campo Slug es la parte que aparece en la URL; si lo defines tú, deja de seguir al nombre).

Nunca elimines una app para cambiarle el nombre. Eliminar una app destruye sus datos de forma permanente: todos sus servicios, volúmenes, variables de entorno, dominios y registros de despliegue, sin posibilidad de deshacerlo. El diálogo te pide escribir el slug de la app para confirmar.

Añade un dominio propio

Para servir la app en tu propio nombre de host, abre Settings → Domains.

1. Escribe el nombre de host (p. ej., app.yourdomain.com) y haz clic en Add domain. Marca Redirect to another host (permanent) si debe redirigir a otro sitio en lugar de servir la app.
2. Apunta el DNS a Cloady con la sección DNS configuration, que muestra los registros exactos que debes copiar:
   • CNAME (predeterminado): un registro que apunta al nombre de host integrado de la app en cloady.io. Lo mejor para subdominios.
   • A / AAAA: para el dominio raíz (apex), que no puede ser un CNAME. Añade ambos registros tal como se muestran.
3. Cuando el DNS resuelve, Cloady configura el HTTPS del host por sí solo. La fila del dominio muestra el progreso: queued → pending → issued (TLS · active). failed (TLS · error) casi siempre significa que el DNS todavía no apunta a Cloady; corrige el registro y se vuelve a intentar.

El nombre de host integrado de cloady.io sigue funcionando junto a tu dominio. También puedes asociar un dominio al desplegar, desde la fila Domains de la tarjeta; allí, Check DNS te dice si los registros ya apuntan a Cloady.

Automatiza con la CLI, la API, Terraform o MCP

Todo lo que hay en el panel se puede automatizar.

• CLI: npm install -g cloady, cloady login y luego cloady deploy github.com/your-org/your-repo. Consulta la referencia de la CLI.
• API REST: crea espacios de trabajo, despliega apps, gestiona dominios y sigue los logs en tiempo real con tokens de API personales. Consulta el resumen de la API y la referencia de endpoints.
• Terraform: declara espacios de trabajo, aplicaciones, variables de entorno y dominios como código, y luego ejecuta terraform apply. Consulta la guía del proveedor de Terraform.
• Servidor MCP: controla Cloady desde un agente de IA, con las mismas operaciones disponibles como herramientas. Consulta la guía del servidor MCP.