Pré-requisitos

Para criar um banco de dados na Zenifra, é necessário ter:

• Uma conta criada e verificada
• Login realizado no console

Acessando a Criação de Projeto

No menu lateral do console, clique em + Criar Projeto.

Passo 1: Escolher o Tipo de Projeto

A Zenifra oferece diferentes tipos de aplicações para deploy:

Aplicação HTTP

Se você precisa hospedar uma aplicação web, veja nosso tutorial de como criar um projeto HTTP.

Banco de Dados PostgreSQL

Cria um banco de dados PostgreSQL gerenciado pela Zenifra, sem necessidade de configurar ou manter o servidor.

O que está incluído:

• PostgreSQL gerenciado com versões estáveis
• Failover automático para projetos com mais de 1 instância
• Instâncias adicionais para alta disponibilidade
• Configuração de conexão via string URI ou parâmetros individuais

Configurações disponíveis:

Conexão:

Após criado, você receberá a string de conexão no formato:

postgres://usuario:senha@host:porta/nome_banco

Dica: Use essa string na variável DATABASE_URL da sua aplicação HTTP para conectar ao banco.

Passo 2: Selecionar o Plano

Os planos definem os recursos disponíveis e o preço do seu banco de dados. Cada plano oferece diferentes níveis de:

• CPU, Memória e GPU
• Armazenamento gratuito (se houver)
• Instâncias para alta disponibilidade

Modelos de Pagamento

Escolha como deseja pagar pelo seu projeto:

Importante: O armazenamento (storage) do banco de dados é persistente e sempre é cobrado, mesmo quando o banco está parado. O que não é cobrado enquanto o banco está inativo é apenas o custo da instância!

Dica: No pagamento por hora, se seu banco rodar apenas 10 minutos no mês, você paga apenas por 1 hora de instância!

Passo 3: Configurar Informações Básicas

Nome do Projeto

O nome é utilizado para:

• Identificar seu banco de dados no dashboard
• Criar subdomínios automáticos

Regras do nome:

• Mínimo: 6 caracteres
• Máximo: 32 caracteres
• Apenas letras minúsculas, números e hífens
• Exemplo: meu-banco-dados, db-producao

Descrição

Campo opcional para adicionar informações sobre o projeto. Ajuda a organizar e identificar projetos quando você tem vários.

Passo 4: Configurar o Banco de Dados

Versão do PostgreSQL

Escolha a versão do PostgreSQL que deseja utilizar:

• PostgreSQL 15
• PostgreSQL 16
• PostgreSQL 17
• PostgreSQL 18

Recomendação: Para novos projetos, recomenda-se usar a versão mais recente (18) para garantir acesso às últimas funcionalidades e correções de segurança.

Usuário do Banco

Nome do usuário administrador do banco de dados.

Senha do Banco

Senha para acesso ao banco de dados.

Importante: Escolha uma senha forte e guarde-a em local seguro. Você precisará dela para conectar ao banco.

Nome do Banco

Nome do banco de dados a ser criado.

Passo 5: Configurar Instâncias

Quantidade de Instâncias

Número total de instâncias do seu banco de dados:

• 1 instância: Ideal para testes ou desenvolvimento
• 3 instâncias: Recomendado para produção com failover automático e consistência de dados

Recomendação:

• Produção: Utilize 3 instâncias para garantir o failover automático caso alguma instância sofra problemas, além de garantir a consistência dos dados.
• Testes/Desenvolvimento: Utilize 1 instância para reduzir custos.

Passo 6: Configurar Armazenamento

Capacidade de Armazenamento

• Mínimo: 1 GB
• Máximo: 250 GB

Atenção: Para modelos de pagamento por hora, o armazenamento só pode ser aumentado, nunca reduzido. Para contratos mensais ou anuais, não é possível alterar o armazenamento após a criação do projeto.

Importante: O armazenamento de banco de dados é cobrado mesmo quando o projeto está parado (não rodando).

Passo 7: Finalizar a Criação

1. Revise todas as configurações
2. Clique em "Criar Projeto"
3. Aguarde alguns segundos para a criação

Após a Criação

Você receberá:

• ID do Projeto: Identificador único do seu banco de dados
• String de Conexão: URI completa para conectar ao banco

Guarde a string de conexão em local seguro! Ela contém as credenciais do seu banco de dados.

Próximos Passos

• Como Conectar sua Aplicação ao PostgreSQL
• Gerenciar Banco de Dados
• Configurações de Pagamento

FAQ

Posso mudar o plano depois de criar o banco de dados?

Depende. Se o modelo de pagamento for por hora, você pode alterar o plano a qualquer momento. Para contratos mensais ou anuais, a mudança só é permitida ao final do período contratado.

Como me conecto ao banco de dados?

Use a string de conexão fornecida após a criação. Você pode conectá-lo via:

• Aplicações web (Node.js, Python, Java, etc.)
• Clientes PostgreSQL (pgAdmin, DBeaver, etc.)
• Linha de comando (psql)

Posso ter múltiplos bancos de dados?

Sim! Você pode criar múltiplos projetos de banco de dados na mesma conta. Cada banco de dados é cobrado independentemente.

Como fazer backup do meu banco de dados?

Você pode exportar os dados usando ferramentas como pg_dump ou conectando-se diretamente ao banco e exportando os dados necessários.

O que acontece se a instância primária falhar?

Para projetos com mais de 1 instância, o failover automático ocorre:

• Uma instância secundária assume como primária
• Uma nova instância secundária é criada automaticamente
• Sua aplicação continua funcionando sem intervenção manual

Como deletar um banco de dados?

1. Acesse a página do projeto em específico
2. Clique em Deletar
3. Confirme a ação

Atenção: Esta ação é irreversível! Todos os dados e configurações serão excluídos permanentemente. Faça backup antes de deletar.