Instalar o FlowX no seu próprio servidor

Antes de começar

A auto-hospedagem é um complemento dos planos Business, Professional e Enterprise. Adicione-a em Configurações → Auto-hospedagem no seu espaço de trabalho na nuvem. Depois de pago, um proprietário ou administrador pode criar o comando de instalação. Prepare um servidor:

• Linux: Ubuntu 22.04 ou 24.04, Debian 12 ou a família RHEL 9.
• Recomendado: 4 CPUs, 8 GB de RAM e 50 GB de SSD. Funciona com 2 CPUs, 4 GB e 20 GB, mas fica lento sob carga.
• Um nome como flowx.yourcompany.com com um registro DNS apontando para o servidor.
• Portas 80 e 443 abertas para quem vai usar o FlowX.
• HTTPS de saída para license.flowx.ninja e get.flowx.ninja. Nada do FlowX se conecta para dentro.
• Sincronização de horário (NTP) ativada. O Docker é opcional: o instalador oferece instalá-lo.

Um servidor acessível só dentro da rede da empresa também funciona: escolha seu próprio certificado, ou a opção de rede interna, durante a instalação.

Instalar em quatro passos

• 1. No espaço de trabalho na nuvem, abra Configurações → Auto-hospedagem e escolha Criar comando de instalação. Ele funciona uma vez, por 24 horas, e é mostrado só uma vez. Um novo comando cancela o anterior.
• 2. Entre no servidor com um usuário que possa usar sudo, cole o comando e pressione Enter. O instalador verifica o servidor primeiro e diz o que corrigir.
• 3. Responda a três perguntas: o endereço que as pessoas vão abrir; o certificado (automático e gratuito, com as portas 80 e 443 acessíveis pela internet; o seu próprio; ou rede interna, que faz os navegadores mostrarem um aviso); e onde ficam os arquivos (o disco deste servidor ou um bucket compatível com S3 que você já tenha).
• 4. Mantenha Configurações → Auto-hospedagem aberta: ela mostra a conexão do servidor, a comunicação regular e o primeiro login à medida que acontecem. Depois abra seu endereço e entre com sua conta FlowX de sempre.

O novo servidor começa vazio. Tarefas, solicitações e arquivos do espaço de trabalho na nuvem não vão para ele sozinhos; fale com o suporte antes de mudar se precisar deles lá.

Logo após a instalação

• Guarde a folha de recuperação que o instalador grava em /opt/flowx/RECOVERY.txt em um gerenciador de senhas ou imprima-a, depois apague o arquivo. Ela contém a única chave que descriptografa seus backups; o FlowX não tem cópia.
• No FlowX do servidor, abra Configurações → Servidor e siga a lista: envio de e-mail (SMTP), recebimento opcional (IMAP), arquivos, backups, janela de atualização e segurança. Cada passo tem um botão Testar.

Comandos do dia a dia

Execute no servidor com sudo:

• flowx status — o que está rodando, a versão e o último backup.
• flowx doctor — uma verificação completa, com uma correção para cada problema encontrado.
• flowx logs api --tail 200 — as últimas linhas de log de um serviço.
• flowx backup now — um backup criptografado e verificado na hora.
• flowx upgrade — faz primeiro um backup verificado e volta sozinho se a nova versão não iniciar. flowx rollback volta à versão anterior manualmente.
• flowx export — tudo em formatos padrão, para quando sair ou precisar de uma cópia.

Se algo der errado

• O instalador para na verificação do nome: o registro DNS precisa apontar para o endereço deste servidor. Mudanças podem levar até uma hora.
• O certificado falha: as portas 80 e 443 precisam estar acessíveis pela internet, ou escolha seu próprio certificado.
• "Token expirado ou usado": crie um novo comando de instalação em Configurações → Auto-hospedagem.
• Erros de assinatura ou de horário: ative a sincronização de horário (NTP) no servidor.
• O login do FlowX está inacessível: sessões já abertas continuam funcionando. O administrador de emergência opcional somente leitura (flowx break-glass) permite ler e exportar enquanto isso.

Obter ajuda

Use o botão Suporte no FlowX para abrir um ticket. Execute sudo flowx support-bundle no servidor e anexe o arquivo: ele contém logs anonimizados e verificações de saúde, nunca o conteúdo do seu espaço de trabalho, e você vê o que ele contém antes de ser gravado.