Saltar al contenido principal
Para alojar una aplicación en Vertra Cloud, inicia sesión en el panel, haz clic en Nuevo Proyecto, sube el código (un .zip o un repositorio de GitHub), comprueba lo que ha detectado la plataforma y despliega. La plataforma instala las dependencias, ejecuta el comando de build si lo hay y arranca el contenedor.
¿Prefieres la terminal? La CLI hace lo mismo con vertra upload, y la extensión de VS Code despliega la carpeta abierta en el editor.

​
Crear una cuenta

La cuenta se crea en el primer inicio de sesión en vertracloud.app/login, sin un formulario de registro aparte. Puedes iniciar sesión con Discord, GitHub, Google o un enlace mágico enviado por correo electrónico. Crear aplicaciones y bases de datos y publicar un sitio requieren un plan activo; sin él, esas peticiones se rechazan con PLAN_REQUIRED. El plan más barato es Economy. Consulta lo que desbloquea cada plan en Planes y límites.

​
¿Cómo es el flujo de Nuevo Proyecto?

El botón Nuevo Proyecto abre un flujo que va paso a paso. La primera pantalla pregunta qué quieres crear y de dónde viene el código:

Subir un .zip

Arrastra el .zip del proyecto. Carpetas como node_modules y venv se eliminan antes de la subida.

Importar desde GitHub

Pega la URL del repositorio o elige entre los repositorios de tu cuenta, incluidos los privados.

Restaurar un snapshot

Crea un proyecto nuevo a partir de un snapshot de otro proyecto tuyo.

Crear una base de datos

PostgreSQL, MongoDB, Redis o MySQL gestionados, con TLS obligatorio.
En la parte superior del flujo eliges en qué workspace se crea el proyecto (tu propia cuenta o un workspace del que formes parte) y, opcionalmente, una carpeta para organizarlo en la lista de proyectos.

​
Crear una aplicación

1

Código fuente

Sube el .zip o indica el repositorio de GitHub. El nombre del proyecto sale del archivo o del repositorio y se puede cambiar aquí, junto con una descripción opcional.Mientras lee el código, la plataforma ya sugiere el runtime, la memoria y los comandos de build y de inicio. Si el .zip incluye un vertracloud.config, sus valores tienen prioridad sobre la sugerencia.
2

Build

Comprueba el archivo principal (elegido de una lista de los archivos del proyecto), el runtime y la versión, y la memoria.En Ajustes avanzados están el comando de inicio y el comando de build. El build se ejecuta antes del inicio, en cada despliegue; si falla, la aplicación no arranca. Los proyectos de Next.js, Nuxt, SvelteKit, Remix, React Router, Astro, Gatsby y Vite ya llegan con ambos comandos rellenados. Si falta una dependencia declarada, el paso muestra un aviso sin impedirte continuar.
3

Entorno

Añade las variables de entorno (hasta 256). PORT, HOST, PATH, HOME, USER y SHELL están reservadas. Detalles en Configuración.
4

Red

Decide si la aplicación tendrá publicación web. Con ella activada, la aplicación recibe una dirección *.vertraweb.app y tiene que escuchar en el puerto 80. Sin ella, la aplicación se ejecuta en segundo plano, como un bot o un worker.
  • La publicación web requiere el plan Pro o superior y al menos 512 MB de memoria.
  • En Pro el subdominio se asigna al azar. Elegir el nombre requiere el plan Scale o superior.
  • Los dominios personalizados requieren el plan Intermediary o superior.
La publicación se puede activar o desactivar más tarde, desde la pestaña Ajustes → Red de la aplicación.
5

Revisar y desplegar

Revisa el resumen y confirma. Si la plataforma rechaza un valor (subdominio en uso, memoria por encima del plan), el flujo vuelve al paso en el que se edita.

​
Qué ocurre durante el despliegue

  1. El código se sube a la plataforma.
  2. Se instalan las dependencias (como npm install o pip install -r requirements.txt), con un límite de 15 minutos.
  3. Se ejecuta el comando de build, si lo hay, con un límite de 10 minutos.
  4. El contenedor arranca con la memoria elegida y el comando de inicio.
  5. Con publicación web, se asigna el subdominio y se emite el certificado TLS.
El .zip puede pesar hasta 100 MB. Crear una aplicación, subir código y desplegar mediante GitHub cuentan para el límite de despliegues por hora del plan.
No subas node_modules, venv, .venv, __pycache__, .next, vendor, .bundle, target, .gradle ni .local. El panel elimina estas carpetas del .zip antes de la subida, pero hacen el archivo más grande y la subida más lenta. Las carpetas de salida del build (dist/, build/) no se eliminan, porque a veces el archivo principal está dentro de ellas.

​
Crear una base de datos

Elige el motor y la memoria, y luego revisa. El almacenamiento se calcula a partir de la memoria y se muestra justo debajo del control. La memoria mínima es de 512 MB para Redis y de 1.024 MB para PostgreSQL, MongoDB y MySQL. Una vez creada, las credenciales y los certificados están en la página de la base de datos. Consulta Bases de datos.

​
Después del despliegue

La página de la aplicación tiene estas pestañas:
  • Resumen: estado y métricas de CPU, memoria, almacenamiento y red.
  • Rollbacks: el historial de versiones, para volver a una versión anterior.
  • Logs: la salida de la aplicación en tiempo real, con eventos de la plataforma (reinicio y pausa temporal por parte de Vertra Shield, cuando corresponda).
  • Archivos: los archivos de la aplicación, con un editor en el navegador (plan Pro o superior).
  • Actividad: el historial de lo que se hizo en la aplicación y quién lo hizo.
  • Snapshots: crea, restaura y descarga copias del proyecto (plan Scale o superior).
  • Ajustes: General (nombre, runtime, memoria, comandos de inicio y de build), Deploy (deploy automático, historial de despliegues), Variables de Entorno, Red (publicación web, subdominio, dominios personalizados) y Zona de Peligro.
Para actualizar el código, sube un .zip nuevo, despliega mediante GitHub o usa vertra deploy. Un simple reinicio no reinstala las dependencias ni rehace el build; para eso, usa Reinstalar Dependencias o Forzar build.

​
Siguientes pasos

Configuración

Todas las claves de vertracloud.config, los campos editables y las variables de entorno.

Despliegue mediante GitHub

Redespliegue automático en cada push.

Tutoriales

Guías por lenguaje, framework y tipo de bot.

Errores comunes

Síntoma, causa y solución de los errores de despliegue más frecuentes.
Última modificación el 26 de octubre de 2026