Como publicar um app Python/Flask pelo Setup Python App do cPanel

Como Publicar um App Python/Flask pelo Setup Python App do cPanel — Guia para Iniciantes (Sensei da GeHost)

Olá, amigo(a) desenvolvedor(a) ou futuro(a) criador(a) de apps! Se você está aqui, provavelmente já criou um app em Python com Flask e quer colocá-lo no ar — com um domínio próprio, sem complicações. Na GeHost, isso é possível com o Setup Python App no cPanel. E eu, seu Sensei da GeHost, vou te guiar passo a passo, com carinho, clareza e um toque de humanidade. Vamos lá?

Dica do Sensei: Antes de começar, certifique-se de que seu domínio está apontando para a hospedagem da GeHost. Se não tiver certeza, entre no Painel do Cliente e confira!

Passo 1: Acesse o cPanel

Primeiro, você precisa entrar no painel de controle da sua hospedagem. Para isso:

1. Abra seu navegador favorito.
2. Vá para https://cpanel.gehost.com.br (ou o endereço fornecido no seu painel).
3. Insira seu usuário (geralmente é o nome do domínio ou algo relacionado) e a senha da hospedagem.
4. Clique em Log in.

Passo 2: Localize o Setup Python App

Depois de logado, você estará na tela principal do cPanel. Procure pelo grupo de ferramentas chamado “Software” ou “Aplicativos”. Dentro dele, você verá uma opção chamada “Setup Python App”.

Se não encontrar, use a barra de busca no topo do cPanel e digite “Python”. O resultado deve aparecer rapidinho.

Passo 3: Crie um Novo App Python

Clique em “Setup Python App”. Você verá uma tela com opções para criar um novo app.

1. Selecione o domínio que você quer usar (ex: seuapp.com.br).
2. Escolha a versão do Python que seu app usa. Se não souber, o padrão geralmente é Python 3.10 ou 3.11. Se estiver em dúvida, use a versão mais recente disponível.
3. Defina o diretório do app. O padrão é public_html/seuapp ou algo parecido. Deixe como está, a menos que tenha um motivo específico para mudar.
4. Defina o arquivo de entrada (main file). Este é o arquivo principal do seu Flask, geralmente chamado de app.py ou main.py. Digite o nome exato aqui.
5. Defina o comando de inicialização. Normalmente é algo como gunicorn app:app (se estiver usando Gunicorn) ou python app.py (se for rodar diretamente).
6. Clique em “Criar App”.

Dica do Sensei: Se o seu app usar Gunicorn, o comando deve ser gunicorn app:app. Se não tiver Gunicorn instalado, instale com pip install gunicorn no seu ambiente local antes de enviar os arquivos.

Passo 4: Envie seus Arquivos via FTP ou Gerenciador de Arquivos

O cPanel não aceita arquivos diretamente no momento da criação do app. Você precisa enviar os arquivos do seu projeto para o diretório definido.

Para isso, use o Gerenciador de Arquivos no cPanel:

1. Na tela do cPanel, clique em “Arquivos” → “Gerenciador de Arquivos”.
2. Selecione o diretório raiz: public_html.
3. Navegue até a pasta onde você criou o app (ex: seuapp).
4. Arraste e solte todos os arquivos do seu projeto Flask aqui (app.py, templates/, static/, requirements.txt, etc.).
5. Verifique se o arquivo principal (ex: app.py) está no lugar certo.

Passo 5: Instale as Dependências (requirements.txt)

Se o seu app usa bibliotecas Python (como Flask, requests, etc.), elas precisam estar instaladas no servidor.

Para isso:

1. No Gerenciador de Arquivos, abra o arquivo requirements.txt (se ele existir).
2. Verifique se todas as bibliotecas estão listadas, uma por linha.
3. Volte ao Setup Python App e clique em “Instalar Dependências” (ou algo similar — o botão pode variar ligeiramente).
4. O sistema vai ler o requirements.txt e instalar tudo automaticamente.

Dica do Sensei: Se o app não rodar, verifique se o requirements.txt está no diretório raiz do app e se o nome está escrito corretamente.

Passo 6: Teste seu App

Pronto! Agora seu app está no ar. Para testar:

1. Acesse o domínio que você escolheu (ex: seuapp.com.br).
2. Se tudo estiver certo, você verá a página inicial do seu Flask.
3. Se aparecer um erro, verifique os logs no cPanel (em “Logs” ou “Logs de Aplicativo”) para ver o que deu errado.

Dica do Sensei: Se não funcionar, não se desespere! O erro mais comum é um arquivo de entrada mal nomeado, versão do Python incorreta ou dependência faltando. Confira tudo com calma. Se precisar, entre em contato com nosso suporte — estamos aqui para te ajudar!

Passo 7: Mantenha seu App Atualizado (dica extra)

Se você atualizar seu app localmente (novas funcionalidades, correções), repita os passos 4 e 5 para enviar os novos arquivos e atualizar as dependências.

Se precisar de ajuda com depuração, logs ou configurações avançadas, o suporte da GeHost está disponível por 30 dias após a entrega — e é só pedir.

Resumo do Sensei

• Use o Setup Python App no cPanel.
• Defina o domínio, versão do Python, arquivo principal e comando de inicialização.
• Envie os arquivos via Gerenciador de Arquivos.
• Instale dependências com requirements.txt.
• Teste no navegador!

Se você seguiu tudo com calma, seu app está no ar — com orgulho, com elegância, com a marca da GeHost. Parabéns, guerreiro do código!

Se tiver dúvidas, só chamar. Estamos aqui. 💙

GeHost — Hosped