Migrating from Bitrix24 Cloud to Self-Hosted: Step-by-Step Plan
Migrar do Bitrix24 nuvem para a versão self-hosted (on-premise) é um processo estruturado de 2 a 4 semanas que envolve implantação do servidor, transferência de dados do CRM, reconfiguração de integrações e testes - com suporte garantido após a virada.
Por que empresas migram da nuvem para o self-hosted
Empresas migram para o self-hosted do Bitrix24 (Alaio) quando enfrentam três pressões simultâneas: exigências de compliance (LGPD, GDPR), necessidade de customizações profundas e um TCO a 3 anos que favorece a licença perpétua sobre a mensalidade crescente por usuário.
A decisão costuma aparecer quando o negócio cresce e surgem três pressões simultâneas: controle total sobre os dados (requisitos de compliance, LGPD, GDPR ou políticas internas), necessidade de customizações que a nuvem não permite, e uma análise de TCO a 3 anos que favorece a licença perpétua. Se você ainda está avaliando essa decisão, vale conferir a análise completa de TCO nuvem vs. self-hosted e o artigo sobre soberania de dados com Bitrix24 on-premise.
Os gatilhos mais comuns que vemos em projetos reais:
- Conformidade regulatória - dados precisam residir em servidor próprio ou datacenter controlado
- Integrações profundas - APIs internas, sistemas legados ou ERP local que exigem acesso direto ao banco
- Customizações de código - módulos próprios, dobramentos de UI ou fluxos de negócio não suportados na nuvem
- Previsibilidade de custo - mensalidade crescente com o número de usuários vs. licença única + renovação anual
Visão geral das fases do projeto
A migração nuvem para self-hosted do Bitrix24 se divide em 4 fases sequenciais - auditoria, implantação do servidor (~7 h), migração de dados e testes com virada - , com prazo total típico de 2 a 4 semanas e 1 mês de suporte garantido após o cutover.
O processo se divide em quatro etapas sequenciais. O fluxo completo, desde a auditoria até o suporte pós-virada:
flowchart TD
A[Fase 1: Auditoria e inventário] --> B[Fase 2: Implantação do servidor self-hosted]
B --> C[Fase 3: Migração dos dados e configurações]
C --> D[Fase 3b: Reconexão de integrações]
D --> E[Fase 4: Testes e virada]
E --> F[Suporte garantido pós-virada]
Fase 1 - Auditoria e inventário: mapeamento completo da estrutura do portal de nuvem - entidades CRM ativas, funis, automações, integrações externas, campos customizados e volume de dados. Entidades obsoletas são excluídas do escopo para não inflar o trabalho.
Fase 2 - Implantação do servidor: configuração do ambiente Linux, instalação do Bitrix24 on-premise, remoção de dados de teste, registro da chave de licença, configuração de Push & Pull para chats, SSL via Let's Encrypt, SMTP para notificações do sistema e backup automático. Tempo estimado: cerca de 7 horas. O cliente pode fornecer acesso SSH (root) ao próprio servidor, ou a equipe de implantação indica um provedor de hospedagem compatível.
Fase 3 - Migração dos dados e reconfiguração: transferência de cada entidade CRM, reconfiguração de automações e reconexão de todas as integrações externas. Detalhado na próxima seção.
Fase 4 - Testes e virada: testes conjuntos com o cliente, ajustes pós-teste, troca de domínio (DNS cutover) e monitoramento pós-lançamento. Após a virada, 1 mês de suporte garantido cobre problemas que não existiam no portal antigo.
O que é transferido - e o que não é
Na migração para o self-hosted, migram campos, funis, automações e permissões das entidades CRM; não migram as atividades do lado direito dos cards (comentários, ligações, e-mails), arquivos anexados a tarefas, histórico de chats e todas as integrações externas, que precisam ser reconectadas do zero.
Esta é a parte mais crítica para alinhar expectativas. A tabela abaixo resume o escopo real com base nos planos de trabalho que executamos:
| Entidade | O que migra | O que não migra |
|---|---|---|
| Usuários e estrutura | Dados de funcionários, departamentos, senhas (entregues em planilha) | Histórico de chats, arquivos do "Meu Disco", calendários pessoais, 2FA |
| Leads | Campos, estágios do funil, cards (lado esquerdo), automações, permissões | Atividades do lado direito do card (comentários, ligações, e-mails, reuniões) |
| Negócios (deals) | Campos, estágios, cards, automações, permissões | Atividades do lado direito do card |
| Contatos e Empresas | Campos, cards, automações, permissões | Atividades do lado direito do card |
| Produtos | Campos, cards de produto | Imagens de produtos; vínculos existentes com negócios/leads |
| Smart Processes | Campos, estágios, automações, permissões | Lado direito do card; importação de dados existentes só via script manual |
| Tarefas | Campos principais (título, responsável, prazo, checklist, tags) | Arquivos anexados, comentários, grupos e suas configurações |
| Modelos de documentos | Estrutura dos templates | Templates precisam ser remapeados (IDs dos campos mudam na migração) |
| Business Processes / Listas universais | Configurações e lógica | Elementos históricos já criados |
| Integrações externas | Configurações são replicadas do zero no novo servidor | Nenhuma integração migra automaticamente - todas precisam ser reconectadas |
Ponto de atenção: como o servidor muda, todas as integrações externas precisam ser reconfiguradas do zero - o cliente deve fornecer acesso aos sistemas integrados durante essa fase.
Detalhamento do esforço por módulo
O esforço de migração varia de ~7 horas para implantação do servidor até 2-15 horas por módulo (integrações externas são o item mais variável), totalizando um prazo de 2 a 4 semanas de calendário para projetos padrão a complexos.
Com base nos planos de projeto que executamos, estes são os intervalos de horas típicos por módulo:
| Módulo | Horas estimadas |
|---|---|
| Implantação do servidor | ~7 h |
| Usuários e estrutura da empresa | 2-5 h |
| Leads | 2-4 h |
| Negócios (deals) | 2-6 h |
| Contatos | 2-4 h |
| Empresas | 2-4 h |
| Produtos | 2-4 h |
| Smart Processes | 2-6 h |
| Modelos de documentos CRM | 2-6 h |
| Tarefas | 2-4 h |
| Business Processes / Listas | 2-4 h |
| Integrações externas | 2-15 h (depende da quantidade e complexidade) |
O prazo total típico de um projeto de migração nuvem → self-hosted fica entre 2 e 4 semanas de calendário.
Scripts de migração: quando o padrão não basta
Para portais com alto volume de dados ou customizações avançadas, scripts PHP/CLI sob medida substituem a exportação/importação padrão do Bitrix24, executados sempre na ordem usuários → estrutura da empresa → dados do CRM para preservar as referências entre entidades.
Para portais com alto volume de dados ou customizações avançadas, a abordagem de exportação/importação padrão do Bitrix24 não é suficiente. Nesses casos utilizamos scripts PHP/CLI desenvolvidos sob medida, que cobrem:
- Migração de usuários com mapeamento de IDs antigos → novos
- Transferência de infoblocks
- Migração de entidades CRM (incluindo timeline, quando aplicável)
- Testes em cópia isolada do banco antes de executar em produção
A sequência de execução sempre segue a ordem: usuários → estrutura da empresa → dados do CRM. Isso garante que as referências entre entidades sejam preservadas corretamente.
Riscos que podem ampliar o escopo e o prazo:
- Incompatibilidade entre customizações existentes e a versão do Bitrix24 no novo servidor
- Uso de APIs obsoletas ou não documentadas no portal de origem
- Código customizado que precisa ser reescrito
- Volume de dados maior do que o identificado na auditoria inicial
Qualquer item nessa lista é tratado como escopo adicional, com estimativa e aprovação do cliente antes da execução. Para entender melhor a estrutura de hardware necessária, consulte o guia de dimensionamento de servidores para Bitrix24 self-hosted.
Hardening de segurança pós-implantação
O hardening pós-implantação do Bitrix24 self-hosted cobre ao menos 8 camadas obrigatórias - do ajuste de innodb_log_file_size e desativação de display_errors até HSTS, restrição de acesso ao admin por IP e antivírus web - , com meta de zero erros críticos no scanner interno.
A implantação técnica inclui um conjunto de configurações de segurança que devem ser aplicadas logo após a instalação:
- Correção de erros na estrutura do banco de dados (verificação automática + manual, até 0 erros)
- Desativação da exibição de erros PHP em produção (
display_errors) - Ajuste do banco de dados: desabilitar
query_cacheelocal_infile; aumentarinnodb_log_file_size - Elevação do nível de proteção proativa - o scanner interno não deve apontar vulnerabilidades críticas
- Adição do header HSTS e redirecionamento HTTP → HTTPS
- Restrição de acesso ao painel administrativo por IP
- Proteção contra uso do portal em iframes (clickjacking)
- Ativação do antivírus web
Para uma checklist completa de 25 pontos, veja o artigo sobre hardening de segurança para Bitrix24 self-hosted.
Testes, virada e suporte pós-migração
A virada para o self-hosted segue 5 etapas - backup, validação pelo cliente, correção de erros, cutover de domínio e monitoramento - com 1 mês de suporte garantido pós-lançamento cobrindo qualquer problema inexistente no portal original, dentro do escopo acordado.
A fase de testes é executada em conjunto com o cliente antes de abrir o acesso para todos os usuários. O fluxo:
- Backup completo do novo portal após a migração
- Entrega do ambiente ao cliente para validação (integrações, funcionalidades, automações)
- Correção de erros identificados nos testes
- Liberação do acesso para usuários finais (cutover de domínio)
- Monitoramento pós-lançamento
Após a virada, o suporte garantido cobre durante 1 mês qualquer problema que não existia no portal original - desde que esteja dentro do escopo acordado no plano de trabalho.
Custos e condições comerciais típicas
A migração nuvem para self-hosted do Bitrix24 custa tipicamente entre USD 900 e 2.000, com prazo de 2 semanas para escopo padrão e até 4 semanas para portais complexos; o pagamento é 100% antecipado ou 50%/50% na assinatura e após o suporte garantido.
Os valores variam conforme a complexidade do portal, volume de dados e quantidade de integrações. Com base em projetos que executamos:
- Migração nuvem → self-hosted (escopo padrão): equivalente a USD 900-2.000 (valores em moeda local variam por região)
- Prazo de execução: 2 semanas para projetos de escopo padrão; até 4 semanas para portais complexos
- Condição de pagamento típica: 100% antecipado, ou 50% na assinatura + 50% após o suporte garantido
Para projetos de implementação completa do zero (sem migração), os custos e cronogramas seguem uma lógica diferente - consulte os dados reais de custo e prazo de implementação do Bitrix24.
Trabalhar com um parceiro no self-hosting. Quer o controle do Bitrix24 self-hosted sem gerenciar o servidor? A ACP Group implanta e opera para voce - veja Bitrix24 self-hosted gerenciado, planos de suporte e manutencao ou peca um orcamento chave na mao.
Frequently asked questions
Quanto tempo leva a migração do Bitrix24 nuvem para self-hosted?
Em projetos de escopo padrão, o prazo típico é de 2 semanas. Portais com alto volume de dados, muitas integrações ou código customizado podem levar até 4 semanas.
Os históricos de conversas e comentários dos cards do CRM são migrados?
Não. As atividades do lado direito do card - comentários, ligações, e-mails, reuniões e histórico de chats - não podem ser exportadas pelas ferramentas padrão do Bitrix24. Apenas os campos estruturados (lado esquerdo) são transferidos.
As integrações com sistemas externos continuam funcionando após a migração?
Não automaticamente. Como o servidor muda, todas as integrações precisam ser reconectadas do zero no novo ambiente. O cliente deve fornecer acesso a todos os sistemas integrados durante essa fase.
Preciso ter meu próprio servidor para fazer a migração?
O ideal é que o cliente forneça um servidor com acesso SSH (root). Caso não tenha infraestrutura própria, a equipe de implementação indica provedores de hospedagem compatíveis com os requisitos do Bitrix24 on-premise.
O que acontece com os Smart Processes durante a migração?
As configurações (campos, estágios, automações e permissões) são migradas. Porém, os dados históricos existentes nos Smart Processes só podem ser transferidos via scripts manuais, pois a importação padrão não é suportada pelo Bitrix24.
Existe suporte após a conclusão da migração?
Sim. Em projetos padrão, o parceiro responsável oferece 1 mês de suporte garantido cobrindo problemas que não existiam no portal original e que estejam dentro do escopo acordado.
Based on real practice
This article is based on 8 internal documents from ACP Group's practice - work plans, specifications and Bitrix24 implementation cases.
Need help with Bitrix24?
ACP Group is a Bitrix24 Gold Partner. We'll review your task, estimate the effort in hours and propose a plan - free of charge.