Este guia serve como uma visão geral de alto nível do processo de migração.
Para detalhes sobre a ampla gama de softwares de fórum para importar, incluindo Vanilla, phpBB3, SMF2, bbPress e vBulletin, revise nossos tutoriais dedicados.
Nem todos os scripts têm tutoriais, mas uma lista exaustiva de importações disponíveis está disponível na pasta script/import_scripts no GitHub. Para migrações maiores, existe também um sistema script/bulk_import mais rápido que escreve diretamente no banco de dados.
Então você quer migrar seu fórum existente para o Discourse? Ótimo! Vamos começar!
1. Configure um Ambiente de Desenvolvimento
Consulte o seguinte tópico para configurar seu ambiente: Set up an environment to migrate another forum to Discourse
(Se você está desenvolvendo um novo importador ou planejando fazer alterações significativas em um importador existente, talvez prefira configurar um ambiente de desenvolvimento. Consulte o guia de instalação para macOS, Ubuntu ou Windows para desenvolvimento.)
2. Leia o Script e Modifique Conforme Necessário
Nós recomendamos fortemente ler o script antes de realizar a importação. Você também pode precisar modificar o arquivo do script antes de começar.
Perto do topo dos scripts, é feita uma conexão com o banco de dados contendo os dados de origem. No mínimo, essas configurações de conexão precisarão ser alteradas.
Você também pode querer alterar as consultas SQL que buscam os dados a serem importados para o Discourse. Por exemplo, se você quiser excluir posts muito antigos, você pode adicionar uma condição às cláusulas WHERE.
3. Execute a Importação
Para executar o script de importação pretendido, execute os seguintes comandos:
cd caminho/para/sua/pasta_discourse
bundle exec ruby script/import_scripts/=import_script=.rb
Este processo será semelhante para outros scripts de importação.
Assim que a importação for concluída, verifique se os dados foram importados corretamente.
4. Faça um Backup e Restaure-o
Se você seguiu este guia e está executando uma instância de desenvolvimento, você precisará fazer um backup do banco de dados e restaurá-lo na instância de produção do Discourse.
Backup e restauração via UI:
Restauração via CLI:
Última Revisão por @sam em 2026-03-16T13:00:00Z