Cómo se versiona Styx (tren global y versión por componente), los canales nightly y stable, y cómo se actualiza y se revierte.
Especificado (
dec-0123, LOCKED). Hoy no hay tags de tren ni canal publicado. Las versiones de componente existen en el repositorio (package.json,build.zig.zon,deploy/VERSION) y las calculabun run release:plan; cada binario debun run release:buildlleva la suya dentro (GET /versionde los servicios,--versiondel daemon y destyx-upload), y fuera de un build de release los servicios dicendev. Mientras no haya un release publicado, el camposincede las páginas esnull. Cómo se corta una release está endocs/governance/release-engineering.md.
dec-0123LOCKED (waxin, 2026-10-03) con su enmienda del 2026-10-02. Coolify es tier 1 con plantilla propia, junto a systemd nativo, Podman Quadlet y Docker Compose. El tren es0.0.0en estado alfa hasta que se corte el primerv0.y.z: los alfas son0.0.0-alpha.N(dec-0133), las nightly son builds de desarrollo marcadas clean o dirty, sólo hay canalesnightlyystable, y beta es un checkpoint opcional. El orden de trabajo lo dan los releases, que empiezan por la aplicación de Coolify del sitio de docs.
| Eje | Esquema | Para qué |
|---|---|---|
| Tren (global) | SemVer 0.y.z, tag git v0.y.z | Lo que ves tú: "estoy en el tren 0.4.2" |
| Componente | SemVer propio, por servicio, daemon, web, CLI… | Lo que mira el operador en styx status |
| Cable | enteros propios (frame de session-ipc, versión de cada contrato del bus, capacidades, conduit) | Compatibilidad entre componentes: la comprueba el CLI |
El tren no se calcula sumando componentes: v0.4.0 significa "este conjunto de versiones, probado
junto". Un PATCH de tren siempre se puede aplicar sin pensar. Un MINOR puede traer migración o
pasos de actualización y se anuncia.
El instalador nunca usa tags móviles: resuelve canal, manifiesto firmado y digests.
styx update --dry-run # muestra el plan sin hacer nada
styx updatestyx update es una transacción: verifica el manifiesto, calcula la ruta (con escalones si la
versión de partida es muy antigua), muestra las notas "antes de actualizar", descarga todo antes
de parar nada, hace una copia de seguridad automática, corre streams y migraciones, intercambia
la versión activa, comprueba la salud (healthchecks, /version igual al manifiesto, conexión con
el daemon, styx verify) y, si algo falla, revierte solo. Es reanudable tras un corte.
La actualización automática es opt-in (notify por defecto, patch o minor) y nunca salta
versiones mínimas, nunca cambia de canal y nunca actualiza con reproducción activa.
styx rollback: rápido (cambio de enlace) si el tren sólo tuvo migraciones aditivas; con
restauración de la copia previa si no, avisando de lo que se pierde.styx backup create|list|restore|prune: pg_dump por base con el rol migrador, configuración,
manifiesto y secretos cifrados con age a una clave de recuperación que se muestra una vez al
instalar. Valkey no entra: es estado efímero.Las migraciones son expand/contract: el código N-1 corre sobre el esquema N, lo que hace barato el rollback.
Instalar
Instalar Styx con un comando sobre el runtime que tengas, y cómo se instala hoy desde el repositorio.
Desplegar la documentación
Runbook para publicar este sitio en Coolify, privado por Tailscale con un dominio .vpn., con basic auth opcional, despliegue continuo detrás de CI verde, rollback y dónde mirar los logs.