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.
Projetos e deploy
Quais linguagens posso publicar?
Pelo GitHub, a Zenifra faz o build de projetos Node.js e Python. Qualquer outra stack (Java, Go, PHP, .NET, Ruby, servidores web) pode ser publicada como imagem OCI. Veja Runtimes.
GitHub ou imagem OCI: qual escolher?
Use GitHub 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 ou Python. A origem não pode ser trocada depois. Veja Implantação.
Como publico automaticamente a cada push?
Em projetos GitHub, selecione Automático por branch. Em projetos OCI, use a GitHub Action oficial para enviar a nova imagem. 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 do projeto 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, disponíveis em planos com o recurso. Veja Rede e controle de acesso.
Cobrança
Como funciona a cobrança por hora?
O uso é arredondado para cima em blocos de 1 hora, com mínimo de 1 hora. Veja Modelos de pagamento.
Quais formas de pagamento são aceitas?
Pix, boleto e cartão de crédito em BRL. 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, o valor fica em aberto e pode ser acompanhado no console. 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]. Envie o ID do projeto, o horário aproximado do problema e a mensagem de erro, sem senhas, tokens ou chaves. Dúvidas comerciais e de pagamento podem ir para [email protected].