Cynchro Cloud — PaaS

Plataforma como servicio (PaaS) self-hosted (al estilo Render / Fly.io / Vercel) corriendo en tu propio VPS. Subís una imagen Docker o un repo Git y obtenés un contenedor corriendo detrás de un dominio HTTPS con certificado Let’s Encrypt automático — sin tocar el servidor.

POST /deploy  →  build/pull de la imagen  →  corre el contenedor  →  https://<app>.cynchro.cloud

---

Dos formas de usarlo

	Dónde	Ideal para
Dashboard	https://app.cynchro.cloud	desplegar, ver logs y secrets con clicks
API REST	https://api.cynchro.cloud	automatización, CI, scripts

Reemplazá cynchro.cloud por tu propio ROOT_DOMAIN si corrés otra instancia. Cada app queda en https://<nombre>.<ROOT_DOMAIN> salvo que pongas un domain propio.

---

Empezá acá

• Primeros pasos — login y tu primera app en 2 minutos.
• Desplegar una imagen Docker — el camino más simple.
• Desplegar desde Git — build desde un repo + webhooks push-to-deploy.
• Apps multi-servicio — varios contenedores como una sola app.
• Secrets — inyectar config/credenciales de forma segura.
• Gestionar apps — logs, restart, stop, delete, límites y cuotas.
• Debugging y bases de datos — el panel Inspect + el gestor Adminer.
• Referencia de API — todos los endpoints y campos.
• Solución de problemas — qué significa cada error y cómo arreglarlo.

---

Conceptos básicos

• Org (tenant) — tu cuenta tiene una org. Cada app/secret vive en ella; nunca ves los recursos de otros tenants.
• App — una unidad desplegable, identificada por un name DNS-safe, único en tu org. Redesplegar el mismo nombre la actualiza en el lugar (idempotente).
• Servicio — un contenedor. Una app normal tiene uno; una multi-servicio tiene varios (exactamente uno es público).
• Deployment — un intento de build/run de una app; tiene logs y estado.
• Secret — un objeto cifrado con pares clave/valor que las apps referencian por nombre.

Cómo funciona (tour de 30 segundos)

1. Llamás a POST /deploy (o usás el form del dashboard).
2. La API del control-plane valida, cifra los secrets y encola un job.
3. Un worker baja o buildea la imagen y arranca el contenedor con límites de CPU/memoria y hardening de seguridad.
4. Traefik (el router de borde) emite el cert Let’s Encrypt y rutea https://<tu-dominio> al contenedor.

Vos solo hablás con la API/dashboard — el resto es automático.

---

Table of contents

• Primeros pasos
• Desplegar una imagen Docker
• Desplegar desde Git
• Apps multi-servicio
• Secrets
• Gestionar apps
• Debugging y bases de datos
• Referencia de API
• Solución de problemas