📍 Base de Conhecimento — site principal: acp-24.com.br →

Migrando do Bitrix24 Nuvem para Self-Hosted: Plano Passo a Passo

Published: · Updated: · 9 min read · Por: Equipe Bitrix24 da ACP Group

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 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 diagrama abaixo ilustra 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 Corporate Portal, 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_cache e local_infile; aumentar innodb_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:

  1. Backup completo do novo portal após a migração
  2. Entrega do ambiente ao cliente para validação (integrações, funcionalidades, automações)
  3. Correção de erros identificados nos testes
  4. Liberação do acesso para usuários finais (cutover de domínio)
  5. 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.

Perguntas Frequentes

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.

Baseado em prática real

Este artigo é baseado em 8 documentos internos da prática do ACP Group — planos de trabalho, especificações, questionários e casos de implementação do Bitrix24.

Precisa de ajuda para implementar o Bitrix24?

ACP Group — Gold Partner of Bitrix24. 7+ years, 1300+ projects.
Call us +971 55 780 1481 or visit our main site.

Go to acp-24.com.br →