Botão "Deploy na Zenifra"
Mantém um projeto open source? Coloque um botão no README para que qualquer pessoa publique a sua aplicação na Zenifra em poucos cliques. O botão é um link para o Console que abre a criação de projeto já preenchida com a origem, a porta e as variáveis de ambiente que você escolheu.
Como funciona para quem clica
- O link abre o Console com o formulário de Novo projeto preenchido.
- Quem ainda não tem conta faz o cadastro (ou o login) e volta direto para o formulário, sem perder o que estava no link.
- A pessoa revisa o nome, o plano e as variáveis, completa os valores que faltam (como chaves secretas) e cria o projeto na própria organização.
Nada é criado só por abrir o link: a criação sempre passa pela confirmação de quem clicou. A aplicação fica ligada o tempo todo, sem espera para "acordar" no primeiro acesso.
Depois de criado, um projeto de repositório público recebe atualizações por deploy manual no Console. Deploy automático a cada push e previews de pull request exigem conectar o GitHub ou o GitLab.
Botão ou Template?
- Botão Deploy na Zenifra: um link para o seu repositório público ou para a sua imagem. Não precisa criar Template nem publicar imagem: o código sai direto do repositório.
- Templates: aplicações prontas do catálogo do Console, como n8n, Metabase e WordPress, com imagem, plano e variáveis sugeridos pelo autor.
Repositório: o Dockerfile não é usado
Com repository, a Zenifra gera a imagem a partir do runtime que você escolher (runtime, version e os comandos), e o Dockerfile do repositório é ignorado. Não é preciso publicar uma imagem para usar o botão. Se o projeto já publica uma imagem, use image no lugar de repository.
Montar o link
O endereço base é https://console.zenifra.com/deploy. Escolha uma origem:
image: uma imagem pública, comoghcr.io/organizacao/aplicacao:latest;repository: o endereço HTTPS de um repositório público, comohttps://github.com/organizacao/aplicacao. Funciona com GitHub, GitLab e outros servidores Git acessíveis por HTTPS, sem que a pessoa precise conectar a conta dela.
Depois, acrescente os parâmetros que quiser:
| Parâmetro | Origem | O que preenche |
|---|---|---|
port | ambas | Porta em que a aplicação escuta, de 1 a 65535. |
env | ambas | Variável de ambiente. Repita o parâmetro para cada uma: env=NOME=valor, ou só env=NOME para a pessoa preencher (use isso para segredos). |
name | ambas | Nome sugerido do projeto (letras minúsculas, números e hífens). O Console acrescenta um sufixo curto, como -a1b2c3d4, para o nome não repetir entre quem clica. Sem name, usa o nome do repositório ou da imagem. |
plan | ambas | Plano sugerido: free (legado, só para organizações que já receberam os planos gratuitos), static, basic, premium, premium_plus, business, deep_learning_basic ou deep_learning_premium. Vale só se a organização de quem clica puder usar esse plano; senão, fica o primeiro plano disponível. |
payment_mode | ambas | Forma de cobrança: hourly (por hora), monthly (mensal) ou yearly (anual). |
branch | repository | Branch publicada. Padrão: main. |
root | repository | Diretório raiz da aplicação dentro do repositório (monorepos), como apps/api. |
runtime | repository | Runtime: nodejs, python, bun, go, java ou php. |
version | repository | Versão do runtime, como 24 ou 3.12. |
start | repository | Comando de inicialização. |
build | repository | Comando de build. |
prebuild | repository | Comando executado antes do build. |
Codifique os valores na URL quando tiverem caracteres especiais: = vira %3D, espaço vira %20 e & vira %26.
Exemplos
O link mínimo tem só a origem e a porta; o restante a pessoa escolhe no Console:
https://console.zenifra.com/deploy?repository=https://github.com/organizacao/aplicacao&port=3000O link completo preenche todos os campos que não são segredo:
https://console.zenifra.com/deploy?repository=https://github.com/organizacao/aplicacao&branch=main&root=.&runtime=nodejs&version=24&prebuild=npm%20ci&build=npm%20run%20build&start=npm%20start&port=3000&name=meu-app&plan=basic&payment_mode=hourly&env=NODE_ENV%3Dproduction&env=API_KEYNele, env=NODE_ENV%3Dproduction é um valor fixo e env=API_KEY chega em branco para a pessoa preencher. Segredos nunca vão na URL: o link fica público no README.
Repositório público em Node.js, com a versão do runtime e o comando de inicialização:
https://console.zenifra.com/deploy?repository=https://github.com/organizacao/aplicacao&runtime=nodejs&version=24&start=npm%20start&port=3000Repositório público em Python, com o comando de inicialização e duas variáveis:
https://console.zenifra.com/deploy?repository=https://github.com/organizacao/aplicacao&branch=main&runtime=python&version=3.12&start=minha-api&port=8000&env=HOST%3D0.0.0.0&env=LOG_LEVEL%3DINFOImagem Docker pública, com uma variável que a pessoa preenche:
https://console.zenifra.com/deploy?image=ghcr.io/organizacao/aplicacao:latest&port=3000&env=API_KEYAdicionar o botão ao README
Use o badge em português ou em inglês e troque o link pelo seu:
[](https://console.zenifra.com/deploy?repository=https://github.com/organizacao/aplicacao&port=8000)[](https://console.zenifra.com/deploy?repository=https://github.com/organizacao/aplicacao&port=8000)Em HTML:
<a href="https://console.zenifra.com/deploy?repository=https://github.com/organizacao/aplicacao&port=8000">
<img src="https://docs.zenifra.com/badge/deploy-pt.svg" alt="Deploy na Zenifra" height="32">
</a>Limites
- O repositório precisa ser público. Para repositórios privados, a pessoa conecta o GitHub ou o GitLab e cria o projeto pelo fluxo normal.
- Um projeto criado a partir de um repositório público é atualizado por deploy manual no Console. Publicação automática a cada push e previews de pull request exigem a conexão com o provedor Git.
- O build usa o runtime escolhido para gerar a imagem da aplicação; um
Dockerfiledo repositório não é usado (veja o aviso em Botão ou Template?). Se o projeto já publica uma imagem, prefira o parâmetroimage. - O link cria uma aplicação. Banco de dados, cache e outros serviços que o projeto precise são criados à parte no Console.
Última atualização em
Deploy a partir do Forgejo
Deploy pelo Forgejo na Zenifra: conecte a instância com um token, escolha o repositório e publique por branch, tag ou release, com previews por pull request.
Ambientes de Preview
Ambientes de preview na Zenifra para PRs do GitHub, GitLab ou Forgejo ou via GitHub Action: TTL padrão de 24h, variáveis herdadas, storage novo, custo por hora.