# Instrucciones para el agente: Postiz: programa redes sociales desde tu infraestructura

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: avanzado
- Proyecto: https://github.com/gitroomhq/postiz-app (licencia AGPL-3.0)
- Guía completa: https://lab.wisd.ai/hub/postiz-social-scheduling

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Preparación

Comprueba que Docker está instalado y en ejecución y que dispone del complemento Compose (`docker compose`). Comprueba también Git para descargar la configuración. Esta ruta usa contenedores; no requiere instalar Node.js ni Python en el host.

### Paso 1: prepara Compose

Sigue la guía oficial de Docker Compose enlazada en el recurso. Descarga su configuración canónica:

```bash
git clone https://github.com/gitroomhq/postiz-docker-compose
cd postiz-docker-compose
```

Entra en la carpeta descargada. Conserva dynamicconfig junto al archivo Compose.

### Paso 2: configura el despliegue

Edita `docker-compose.yaml`: sustituye `JWT_SECRET` por un secreto aleatorio propio. Para esta prueba local conserva `MAIN_URL` y `FRONTEND_URL` en `http://localhost:4007`, `NEXT_PUBLIC_BACKEND_URL` en `http://localhost:4007/api`, las direcciones internas de base de datos, Redis y Temporal, y los volúmenes. Si cambias la contraseña de Postgres, actualízala también en `DATABASE_URL`. La [configuración canónica](https://github.com/gitroomhq/postiz-docker-compose/blob/main/docker-compose.yaml) contiene los nombres exactos; no basta crear variables que Compose no referencia. Registra la aplicación de la red que vayas a probar según su guía de proveedor.

### Paso 3: inicia los servicios

Desde la carpeta del archivo Compose:

```bash
docker compose up
```

## Comprobación

Abre http://localhost:4007 si mantuviste los valores documentados. Crea una cuenta local en el formulario de registro y entra con ella. Comprueba los registros de inicio y el panel de Temporal en http://localhost:8080. Conecta un canal de prueba y revisa un borrador antes de programarlo.

## Si algo falla

Si falla un canal, revisa sus permisos y la configuración del proveedor. Si vienes de una versión anterior a Temporal, sigue la guía de migración indicada en la documentación antes de actualizar.

Fuente: [documentación oficial](https://github.com/gitroomhq/postiz-app#readme).