Gerenciando o servidor local
Useyarn twenty docker:* para controlar o contêiner Twenty local:
Os dados são persistidos entre reinicializações em dois volumes do Docker (
twenty-app-dev-data para PostgreSQL, twenty-app-dev-storage para arquivos). Use reset para apagar tudo.
Fixando a versão do servidor
Quando nenhuma versão é passada,docker:start resolve a versão a partir do intervalo engines.twenty do seu app em package.json — o mesmo intervalo que o servidor valida quando o seu app é instalado. Ele inicia a imagem mais recente publicada de twenty-app-dev que satisfaz o intervalo, recorrendo a latest quando o campo está ausente ou nenhuma versão publicada corresponde:
yarn twenty docker:start 2.3.0. Se já existir um contêiner em uma versão diferente, docker:start faz o upgrade dele no lugar (recriando o contêiner enquanto preserva seus volumes de dados).
Atualizando a imagem do servidor
yarn twenty docker:upgrade baixa a imagem mais recente, compara os digests e só recria o contêiner se algo realmente tiver mudado. Os volumes são preservados — apenas o contêiner é substituído. Se uma nova imagem foi baixada e o contêiner estava em execução, a atualização inicia automaticamente um novo contêiner; execute yarn twenty docker:start depois para aguardar até que ele fique saudável.
yarn twenty docker:status (ele mostra o APP_VERSION incorporado ao contêiner).
Executando uma instância de teste paralela
Passe--test para qualquer comando docker:* para gerenciar uma segunda instância totalmente isolada — útil para testes de integração ou para experimentar sem tocar nos seus dados principais de desenvolvimento:
A instância de teste tem seu próprio contêiner (
twenty-app-dev-test), volumes (twenty-app-dev-test-data, twenty-app-dev-test-storage) e configuração — ela é executada junto com sua instância principal sem conflitos. Combine --test com --port para substituir 2021.
Configuração manual (sem o gerador)
Ignore o gerador se você estiver adicionando o SDK a um projeto existente:package.json:
yarn twenty dev, yarn twenty docker:start e o restante.
Não instale
twenty-sdk globalmente — fixe-o por projeto, para que cada aplicativo use sua própria versão.