Perguntas frequentes

Respostas curtas para as dúvidas mais comuns. Cada resposta aponta para a página com os detalhes.

Conta e organização

Preciso de CNPJ para usar a Zenifra?

Não. Contas CPF e CNPJ funcionam da mesma forma, sempre por meio de organizações. Veja Cadastro.

Posso trabalhar em mais de uma empresa com a mesma conta?

Sim. Uma conta pode participar de várias organizações e alternar entre elas no console. Projetos, cobrança e API keys ficam separados por organização. Veja Organizações.

Como dou acesso a outra pessoa sem entregar tudo?

Convide a pessoa para a organização e conceda apenas as permissões necessárias, por exemplo leitura de um único projeto. Veja Convidar membros e Permissões granulares.

Por repositório Git (GitHub ou Forgejo), a Zenifra faz o build de projetos Node.js, Python e Bun. Qualquer outra stack (Java, Go, PHP, .NET, Ruby, servidores web) pode ser publicada como imagem OCI. Veja Runtimes.

Repositório Git ou imagem OCI: qual escolher?

Use um repositório GitHub ou Forgejo quando quer que a plataforma faça o build a partir do código. Use imagem OCI quando o build já acontece no seu CI ou a stack não é Node.js, Python ou Bun. Em projetos Git, a conexão, o repositório e a branch podem ser alterados depois pela API ou pela CLI (zenifra project source). Veja Implantação.

Como publico automaticamente a cada push?

Em projetos GitHub ou Forgejo, selecione Automático por branch. Em projetos OCI, use a GitHub Action oficial para publicar a nova imagem a cada push. Veja Atualização automática por branch.

Como volto para uma versão anterior?

Veja Rollback. Em projetos OCI, basta publicar novamente a tag anterior.

Minha aplicação não sobe. Por onde começo?

Confira se a aplicação escuta na porta configurada no projeto, abra os logs de build (projetos Git) e os logs do projeto (disponíveis em todos os planos) e siga o guia de solução de problemas.

Os arquivos gravados pela aplicação somem ao reiniciar. Por quê?

O sistema de arquivos da instância é efêmero. Para manter arquivos, configure armazenamento persistente na criação do projeto.

Bancos de dados e serviços

A Zenifra cria a `DATABASE_URL` automaticamente na minha aplicação?

Não. Copie os dados de conexão do banco no console e cadastre a variável no projeto da aplicação. Veja Variáveis de ambiente.

Quais bancos estão disponíveis?

PostgreSQL, MariaDB, Valkey (Chave-Valor, Cache e Filas) e ClickHouse para Analytics. Veja Banco de Dados, Serviços gerenciados e Analytics.

Domínios e rede

Posso usar meu próprio domínio?

Sim, em projetos HTTP públicos, depois da criação. Veja Domínios personalizados.

Como restrinjo o acesso a alguns IPs?

Use a whitelist e a blacklist, com até 10 endereços IPv4 ou faixas CIDR cada, disponíveis a partir do plano Premium Plus. Veja Rede e controle de acesso.

Cobrança

Como funciona a cobrança por hora?

A cobrança é proporcional ao tempo em execução, incluindo frações de hora, multiplicada pelo número de instâncias; não há arredondamento para a hora cheia nem mínimo de 1 hora. Veja Modelos de pagamento.

Quais formas de pagamento são aceitas?

O saldo da organização é recarregado por Pix ou boleto, em BRL. O cartão de crédito fica salvo para a cobrança automática quando o saldo não cobre um valor. O crédito é compartilhado entre projetos, bancos e IA. Veja Gestão de pagamentos.

O que acontece quando o crédito acaba?

A plataforma tenta cobrar o cartão cadastrado. Sem cartão, ou se a cobrança falhar, o valor fica em aberto e pode ser acompanhado no console. Pelos Termos de Uso, após 2 ciclos mensais consecutivos sem pagamento a conta é bloqueada e os projetos podem ser pausados. A IA é pré-paga e para de responder sem crédito.

Segurança e suporte

Onde guardo segredos?

Em variáveis de ambiente do projeto, nunca no repositório. Para automações, use API keys com o mínimo de scopes. Veja Segurança.

Como falo com o suporte?

Pelo e-mail [email protected] ou pelo WhatsApp e telefone +55 (11) 5199-3013. O compromisso de resposta é de até 2 dias úteis. Envie o ID do projeto, o horário aproximado do problema e a mensagem de erro, sem senhas, tokens ou chaves. Para acompanhar a disponibilidade da plataforma, consulte status.zenifra.com. Veja Central de ajuda.