Administrar el servidor local
Usayarn twenty docker:* para controlar el contenedor local de Twenty:
Los datos se conservan entre reinicios en dos volúmenes de Docker (
twenty-app-dev-data para PostgreSQL, twenty-app-dev-storage para archivos). Usa reset para borrar todo.
Fijar la versión del servidor
Cuando no se pasa ninguna versión,docker:start resuelve la versión a partir del rango engines.twenty de tu aplicación en package.json, el mismo rango con el que el servidor valida cuando tu aplicación se instala. Inicia la imagen publicada más reciente de twenty-app-dev que satisface el rango, recurriendo a latest cuando el campo está ausente o ninguna versión publicada coincide:
yarn twenty docker:start 2.3.0. Si ya existe un contenedor en una versión diferente, docker:start lo actualiza in situ (recreando el contenedor mientras conserva tus volúmenes de datos).
Actualización de la imagen del servidor
yarn twenty docker:upgrade descarga la última imagen, compara los digests y solo recrea el contenedor si realmente cambió algo. Los volúmenes se conservan — solo se reemplaza el contenedor. Si se descargó una nueva imagen y el contenedor estaba en ejecución, la actualización inicia automáticamente un contenedor nuevo; ejecuta yarn twenty docker:start después para esperar a que esté en buen estado.
yarn twenty docker:status (muestra el APP_VERSION incluido en el contenedor).
Ejecutar una instancia de prueba en paralelo
Pasa--test a cualquier comando de docker:* para administrar una segunda instancia completamente aislada — útil para ejecutar pruebas de integración o experimentar sin tocar los datos principales de desarrollo:
La instancia de prueba se ejecuta en su propio contenedor de Docker (
twenty-app-dev-test) con volúmenes dedicados (twenty-app-dev-test-data, twenty-app-dev-test-storage) y configuración dedicada, por lo que puede ejecutarse en paralelo con la instancia principal sin conflictos. Combina --test con --port para anular el puerto predeterminado (2021).
Configuración manual (sin el generador)
Omite el generador si vas a agregar el SDK a un proyecto existente:package.json:
yarn twenty dev, yarn twenty docker:start y todos los demás comandos.
No instales
twenty-sdk globalmente — fíjalo por proyecto para que cada app use su propia versión.