Inicio rápido de la app

Inicio rápido de apps

Este inicio rápido despliega una app en Lizard (lizard.build) en unos minutos. Instala Lizard CLI, inicia sesión, empieza la prueba de Pro de 7 días y luego ejecuta lizard add -r owner/repo para un repositorio de GitHub o lizard up para una carpeta local. Lizard compila la app en sus servidores, sin Docker local, y devuelve una URL HTTPS en onlizard.com. Tu cuenta se crea la primera vez que ejecutas lizard login.

1. Instala la CLI

En macOS o Linux, ejecuta el script de instalación:

curl -fsSL https://lizard.build/install.sh | bash

Instala el binario lizard en ~/.lizard/bin, añade esa carpeta a tu PATH en ~/.zshrc o ~/.bashrc, y enlaza lizard en una carpeta que ya está en tu PATH, así que funciona al momento en esta terminal. Desde entonces el binario se actualiza solo, salvo en CI. Si el script avisa de que quizá no se encuentre lizard, abre una terminal nueva. Comprueba la versión:

lizard --version

En Windows, ejecuta esto en PowerShell:

irm https://lizard.build/api/cli/install.ps1 | iex

O instala desde npm (requiere Node.js 18+):

npm install -g @lizard-build/cli

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. Para actualizar más adelante una instalación de npm, ejecuta npm install -g @lizard-build/cli@latest.

¿Errores de permisos (EACCES)? No uses sudo. Usa el script de instalación de arriba, que no necesita permisos de administrador, o 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=liz_xxx
# or
lizard login --token liz_xxx

Las claves de API empiezan por liz_. Crea una con lizard keys create <name>. LIZARD_API_KEY funciona en lugar de LIZARD_TOKEN.

Comprueba quién eres en cualquier momento:

lizard whoami

3. Empieza la prueba de Pro

Una cuenta nueva no tiene plan, así que crear cualquier cosa devuelve HTTP 402 con un enlace de Checkout. Empieza primero la prueba de Pro de 7 días:

lizard billing start

Esto abre Stripe Checkout, donde añades una tarjeta. La prueba incluye $5 de uso y no se cobra nada hasta que termina. Consulta Facturación y lizard billing.

4. 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 con lizard git:

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-x1y2z.onlizard.com.

Lizard detecta la mayoría de los stacks por sí solo. Para el comando de compilación, el comando de inicio y el puerto exactos de tu framework, consulta la guía de Next.js, React, Vue, Astro, SvelteKit, Node.js, Django, FastAPI, Rails o Go. Una app con su propio Dockerfile sigue Desplegar con un Dockerfile.

5. 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

lizard open muestra el mismo proyecto en el panel. Para métricas, costos e historial de despliegues, consulta Observabilidad.

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

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

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

La referencia ${{postgres.DATABASE_PRIVATE_URL}} se resuelve en el momento del despliegue y se conecta por la red privada del proyecto. Coincide con el nombre actual del addon, así que actualiza la referencia si le cambias el nombre al addon. Las credenciales no rotan solas; un servicio recoge los valores nuevos en su siguiente despliegue. Consulta Managed Addons.

Siguientes pasos

Costes de hosting

Pro cuesta $19 al mes con $19 en créditos mensuales. El uso por encima de eso es pay as you go a las tarifas publicadas. Pro empieza con una prueba de 7 días y $5 en créditos de prueba; añades una tarjeta para empezarla. Consulta Facturación y los precios, y revisa tus límites antes de desplegar.

IntroducciónInstalar Lizard Studio

Actualizado