---
title: Despliegue
description: Compila y despliega tu sitio de documentación Thally en cualquier plataforma de alojamiento.
url: https://docs.thally.io/es/guides/deploying
---

# Despliegue

Compila y despliega tu sitio de documentación Thally en cualquier plataforma de alojamiento.

## Compilar para producción

```bash
npm run build
```

Esto genera una compilación de producción optimizada en el directorio `.next/`. Todas las páginas de documentación se pre-renderizan de forma estática para una carga rápida.

## Variables de entorno

Antes de desplegar, establece la variable de entorno `THALLY_SITE_URL` con tu dominio de producción. Se utiliza para los metadatos de OpenGraph y las URLs canónicas:

```bash
THALLY_SITE_URL=https://docs.yourproduct.com
```

## Analíticas y almacenamiento durable

En local, Thally guarda analíticas y estado del admin en archivos SQLite bajo `.data/` — sin configuración. En hosts **serverless** (por ejemplo Vercel), ese sistema de archivos no persiste: necesitas una base de datos libSQL remota (Turso) si quieres métricas de tráfico o ajustes del admin durables.

```bash
THALLY_ANALYTICS_DB_URL=libsql://tu-db.turso.io
THALLY_ANALYTICS_DB_TOKEN=…
THALLY_DATABASE_URL=libsql://tu-db.turso.io
THALLY_DATABASE_TOKEN=…
```

Consulta la [configuración para sitios autohospedados](/guides/environment-variables#keep-self-hosted-state-after-a-redeploy) para los detalles. Agent Readiness no usa esta base de datos.

## Cloudflare Workers

Consulta [Desplegar en Cloudflare Workers](/guides/deploy-cloudflare) para el
flujo completo de compilación, prueba y verificación.

El repositorio incluye el adaptador OpenNext y un `wrangler.jsonc` listo para
usar. Compila el Worker, ejecuta el mismo artefacto localmente con workerd y
despliégalo:

```bash
npm run build:cloudflare
npm run smoke:cloudflare
npm run deploy:cloudflare
```

La compilación crea `.open-next/worker.js` y su directorio de activos estáticos.
Configura `THALLY_SITE_URL` y los secretos opcionales en el entorno del Worker
antes del despliegue de producción. Thally Cloud realiza estos pasos
automáticamente para los sitios administrados.

## Vercel

Consulta [Desplegar en Vercel](/guides/deploy-vercel) para la configuración de
variables, almacenamiento persistente y verificación.

La forma más rápida de desplegar — sube a GitHub e importa el repositorio:

1. Sube tu repositorio de documentación a GitHub
2. Ve a [vercel.com/new](https://vercel.com/new) e importa el repositorio
3. Establece `THALLY_SITE_URL` en las variables de entorno
4. Si quieres analíticas del admin, también configura las variables de Turso de arriba
5. Despliega

Vercel detecta automáticamente Next.js y configura todo.

## Docker

Consulta [Desplegar con Docker](/guides/deploy-docker) para crear un contexto de
compilación que excluya secretos, ejecutar el proceso como usuario sin
privilegios y conservar `.data/` en un volumen.

## Exportación estática

Si no necesitas funcionalidades del lado del servidor (como el proxy de Prueba), puedes exportar como un sitio completamente estático. Agrega a `next.config.ts`:

```ts
const nextConfig = {
  output: 'export',
}
```

Luego ejecuta `npm run build` — la salida estará en el directorio `out/`, lista para cualquier servidor de archivos estáticos.

> **Limitación de la exportación estática:**
  La exportación estática no incluye rutas del servidor. No funcionan el panel
  "Pruébalo", el chat de IA, MCP remoto, el panel de administración, las
  analíticas, la protección por contraseña ni los webhooks de Thally Track.

## SEO y feeds

Una vez desplegado, Thally sirve automáticamente:

- **`/sitemap.xml`** — incluye todas las páginas de documentación, páginas de referencia de la API y el registro de cambios
- **`/robots.txt`** — permite a los rastreadores en todas las páginas, bloquea `/admin`, `/access` y las rutas internas `/api/chat`, `/api/feedback`, `/api/try-it`, `/api/admin` y `/api/analytics`
- **`/changelog/rss.xml`** — feed RSS para las actualizaciones del registro de cambios
- **Imágenes OG dinámicas** — cada página obtiene una imagen de vista previa social personalizada a través de `/api/og`

Todos estos usan `THALLY_SITE_URL` para generar URLs absolutas, así que asegúrate de que esté configurado antes de desplegar.