---
title: "Deploy de Node.js, Python e PHP a partir do GitHub - Vixpi"
description: "Como publicar um app a cada push: conectar o repositório, escolher entre arquivos e imagem, configurar o vixpi.json e disparar o deploy pelo GitHub Actions."
canonical: "https://vixpi.host/blog/deploy-node-python-php-github"
---

# Deploy de Node.js, Python e PHP a partir do GitHub - Vixpi

> Como publicar um app a cada push: conectar o repositório, escolher entre arquivos e imagem, configurar o vixpi.json e disparar o deploy pelo GitHub Actions.

# Deploy de Node.js, Python e PHP a partir do GitHub

Publicar por FTP funciona até o dia em que um arquivo sobe pela metade e o site cai. Com deploy a partir do Git, cada push vira uma versão com histórico, log e caminho de volta. Este guia mostra como isso funciona na Hospedagem de Sites da Vixpi, de conectar o repositório até disparar o deploy pelo GitHub Actions.

 Equipe Vixpi  4 min de leitura Publicado em 08/11/2026 

## Conectar o repositório

Cada aplicação da conta tem o próprio repositório, configurado em Deploys, Configurar. Com GitHub, o caminho recomendado é Conectar GitHub: você instala o app Vixpi Host na sua conta ou organização e escolhe o repositório. Não há chave de deploy nem webhook para cadastrar.

Para outro servidor Git, o painel mostra uma chave de deploy de leitura, a URL do webhook e o segredo do webhook. Você cadastra a chave e o webhook no servidor Git e marca só o evento de push. O segredo aparece uma única vez; se perder, gere outro, sabendo que o antigo deixa de valer na hora.

## Publicar a cada push

Com a opção Publicar a cada push na branch ligada, cada push na branch configurada dispara um deploy. Também dá para publicar à mão pelo botão Publicar, que fica no topo das telas da aplicação.

O histórico lista cada deploy com commit, data e estado, e os logs de cada fase. Um deploy em andamento pode ser cancelado, e um concluído pode ser revertido para uma versão anterior que ainda esteja disponível. As duas ações pedem confirmação.

## Arquivos ou imagem

O modo de publicação vale para todas as aplicações da conta. No modo Arquivos, o padrão, o código vai para a pasta da aplicação e roda no runtime escolhido. O agente instala as dependências e roda o script build se ele existir: npm ci ou npm install no Node.js, bun install no Bun e composer install no PHP. O Dockerfile do repositório é ignorado nesse modo.

No modo Imagem, cada deploy gera uma imagem nova. O agente decide como construir nesta ordem: vixpi.json, Dockerfile, compose.yaml, Railpack, Nixpacks e templates. O app precisa escutar na porta da variável PORT, e portas abaixo de 1024, como a 80, não funcionam, porque o container roda com o usuário da sua conta. Esse modo consome os minutos de build do plano.

## Runtimes e frameworks

A hospedagem roda PHP de 8.1 a 8.4, também com FrankenPHP, Node.js 20, 22 e 24, Bun 1 e Python de 3.11 a 3.13\. Java e .NET rodam só no plano Site Business, no modo Imagem. Os runtimes liberados em cada plano estão na tabela de planos em vixpi.host/sites.

Qualquer aplicação que escute numa porta HTTP serve: Laravel, Symfony e Slim no PHP; Next.js, Nuxt, Express, NestJS e Hono no Node.js e no Bun; Django, FastAPI e Flask no Python.

## vixpi.json: quando a detecção não basta

O vixpi.json na raiz do repositório tem prioridade sobre qualquer outro método de build. Só o campo runtime é obrigatório, com php, node, bun, python, static ou custom. Os outros ajustam o que a detecção faria sozinha.

O arquivo é validado antes do build. Com erro, o deploy falha logo na detecção com o código VIXPI\_JSON\_INVALID, apontando o campo e o motivo, e a versão no ar não é tocada.

- version: a versão do runtime, como "22" ou "8.4".
- install, build e start: os comandos de cada fase. O start vira o comando do container, sem expansão de shell.
- port e healthcheck: a porta em que o app escuta e o caminho conferido antes da troca de versão. Qualquer resposta abaixo de 500 conta como saudável.
- persistent: pastas, como storage, preservadas entre deploys no modo Arquivos.
- workers e cron: processos em segundo plano e tarefas agendadas, como a fila e o schedule do Laravel.

## Troca de versão sem derrubar o site

A versão nova sobe ao lado da atual, passa no healthcheck e só então recebe o tráfego. É o que se chama de deploy blue-green. Se a versão nova não passar, a antiga continua no ar e o deploy mostra o erro.

Na prática, um build quebrado ou uma variável esquecida aparecem no log do deploy, e não para quem está visitando o site. Os workers e as tarefas de cron do vixpi.json só são recriados depois que a versão nova está no ar.

## Deploy pelo GitHub Actions

Quando o build roda no seu próprio CI, use um token de CI. Ele só dispara deploys daquela aplicação: não lê arquivos nem muda configuração. Crie o token em Deploys, Configurar, Tokens de CI, e copie na hora, porque ele aparece uma única vez. Revogado, o CI que o usa deixa de publicar no mesmo instante.

No GitHub, guarde o token como secret VIXPI\_DEPLOY\_TOKEN e defina VIXPI\_API\_URL nas variables do Actions. O workflow chama POST /api/v1/hosting/deploy com o token no cabeçalho Authorization: Bearer. Com { "ref": "main" }, a Vixpi clona o repositório configurado e faz o build. Com { "image": "ghcr.io/sua-org/app:1.0.0" }, baixa a imagem pronta e troca a versão sem build. A imagem precisa ser linux/amd64, e a credencial de registry privado vai em registryAuth, guardada cifrada.

O workflow pronto para colar está na própria tela de Deploys, e o guia completo, com os erros possíveis, em vixpi.host/ajuda/hospedagem/git-github-actions.

Coloque em prática na Vixpi

Deploy por Git com troca de versão que não derruba o site.

[Ver hospedagem de sites ](https://vixpi.host/sites)

## Continue lendo

- [ Hospedagem Como hospedar bot de Discord, Telegram e WhatsApp 24 horas  5 min](https://vixpi.host/blog/hospedar-bot-discord-telegram-whatsapp-24h)
- [ Hospedagem Suporte 24/7 com IA e equipe: como funciona o atendimento  4 min](https://vixpi.host/blog/atendimento-24-7-ia-e-equipe)
- [ Hospedagem O que é DNS?  4 min](https://vixpi.host/blog/o-que-e-dns)
