Guia oficial de auto-hospedagem

Comece instalando o aplicativo para desktop. Ele abrirá o mesmo núcleo minddy público na pasta local ou servidor que você controla.

Mesmo produto, operador diferente

O minddy auto-hospedado usa a versão pública. Você escolhe a infraestrutura e assume a responsabilidade por sua operação.

  • Crie e gerencie suas próprias contas de usuário
  • Não são necessários Stripe, PostHog ou provedor gerenciado
  • Seus backups, atualizações e resposta a incidentes

01

Como funciona a auto-hospedagem

O aplicativo de desktop abre a interface do minddy a partir da fonte de dados escolhida. Por trás dele, o serviço Next.js auto-hospedado e o Supabase fornecem o rastreador, as contas, os anexos e as atualizações em tempo real.

minddy executa a interface

O aplicativo Next.js disponibiliza o rastreador e sua API.

Supabase executa o back-end

Auth, Postgres, Storage e Realtime funcionam como uma pilha.

Seu armazenamento mantém os dados

Projetos, contas e anexos permanecem na infraestrutura que você escolher.

O PostgreSQL sozinho não é compatível. minddy também precisa de Supabase Auth, armazenamento e tempo real.

02

Duas maneiras de executá-lo

Todas as opções começam pelo aplicativo de desktop e usam a mesma versão de código aberto. Escolha de acordo com o público: somente você ou uma equipe inteira.

Início rápido

Só eu, neste computador

Uma instância local privada para um desenvolvedor, gerenciada a partir do aplicativo de desktop sem administração de domínio ou servidor.

  • 1 usuário
  • Somente local
  • Opção local com baixo consumo de memória
Instalar a opção local
Configuração de produção

Várias pessoas, em um servidor

Execute uma instância compartilhada em um VPS ou em uma máquina em casa. Comece em sua rede privada sem um domínio ou torne-a pública com HTTPS.

  • Vários usuários
  • Privada ou pública
  • Host dedicado
Instalar a opção para equipes

03

Migrando do Minddy Cloud?

Seus dados não precisam ficar para trás. Exporte-os da nuvem como um arquivo JSON, instale sua própria instância com o assistente e importe o arquivo nela — projetos, problemas, comentários e anexos irão junto.

1. Exportar da nuvem

Configurações → Dados → “Baixar meus dados”. Você obtém um arquivo minddy-export-….json sem senhas ou chaves dentro.

2. Importe para sua instância

Configurações → Dados → “Importar um arquivo de transferência”. A importação é aditiva: ela mantém os identificadores originais quando estão disponíveis e informa tudo o que precisou ser remapeado.

As credenciais nunca viajam no arquivo: reconecte GitHub, GitLab e provedores de IA dentro do aplicativo após a importação.

O que auto-hospedagem inclui

O núcleo público inclui o rastreador, administração, exportações, MCP e caminhos de agente documentados. IA, e-mail, Git, análises, push e armazenamento externo são opcionais: selecione e configure apenas os provedores que deseja usar.

O faturamento na nuvem e a análise de produtos não são pré-requisitos. Com apenas as configurações necessárias, a instância não chama Minddy Cloud, Stripe, PostHog ou um provedor de IA.

Após o primeiro login

Mantenha o runbook da sua versão implantada. Essas ações fazem parte da execução de uma instância compartilhada.

Abrir o guia de backup e atualização