Inicio rápido de la app

Inicio rápido de apps

Lanza tu primera app en Lizard en unos minutos. Necesitarás Node.js 18+ y npm; se crea una cuenta de Lizard automáticamente la primera vez que lizard login. Instalarás la CLI, iniciarás sesión y desplegarás, ya sea directamente desde un repositorio de GitHub o desde un directorio local.

1. Instala la CLI

Instala globalmente desde npm el binario lizard:

npm install -g @lizard-build/cli

Verifica que esté en tu PATH:

lizard --version

No uses npx. Usa siempre el binario lizard instalado globalmente. Ejecutar npx @lizard-build/cli descarga una copia temporal cuya versión puede diferir de la plataforma. Más adelante, actualízalo en el mismo lugar con lizard upgrade.

¿Errores de permisos (EACCES)? No uses sudo. Haz que npm apunte a un prefijo propiedad de tu usuario:

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc && source ~/.zshrc
npm install -g @lizard-build/cli

2. Inicia sesión

lizard login

Esto abre tu navegador para autenticarte y luego vuelve a tu terminal una vez que confirmes. En CI u otros entornos no interactivos, autentícate con un token en su lugar:

export LIZARD_TOKEN=lzd_xxx
# or
lizard login --token lzd_xxx

Comprueba quién eres en cualquier momento:

lizard whoami

3. Despliega

Elige la ruta que coincida con dónde vive tu código.

Opción A — Desplegar un repositorio de GitHub (recomendado)

Si tu código está en GitHub, crea un servicio directamente desde el repositorio. Lizard lo clona, detecta automáticamente el stack, lo compila y devuelve una URL activa:

lizard add -r your-org/your-app

A partir de entonces, los pushes a la rama seguida volverán a desplegar automáticamente. Para repositorios privados, conecta primero la GitHub App:

lizard git connect

Opción B — Desplegar código local

Desde dentro del directorio de tu proyecto, sube y despliega la carpeta actual (respeta .gitignore):

lizard up

Si el directorio aún no está vinculado a un proyecto, up creará o seleccionará uno de forma interactiva. En CI, vincúlalo explícitamente primero con lizard init --name my-project.

De cualquier forma, cuando termine la compilación obtendrás una URL generada como https://your-app-production.onlizard.com.

4. Observa cómo compila y se ejecuta

lizard ps          # services in the project, with status + URL
lizard logs        # last runtime log lines
lizard logs --build  # the most recent build's logs
lizard open        # open the project in the dashboard

5. Añade una base de datos (opcional)

Aprovisiona un Managed Postgres y haz referencia a él desde tu servicio:

lizard add postgres
lizard secrets set DATABASE_URL='${{postgres.DATABASE_URL}}' --service your-app
lizard redeploy --service your-app

La referencia ${{postgres.DATABASE_URL}} se resuelve en el momento del despliegue y rota automáticamente con el addon. Consulta Managed Addons.

Siguientes pasos

Costes de hosting

Lizard usa pay as you go sin suscripción mensual. El uso de recursos se descuenta de tu saldo de cuenta. Los créditos comprados no caducan; los créditos de prueba sí. Consulta los precios y los límites de tu cuenta antes de desplegar.