Como configurar um ambiente Python (Django/Flask) na GeHost — Guia para Iniciantes
Olá, querido(a) desenvolvedor(a)! Seja bem-vindo(a) ao seu primeiro passo rumo ao mundo do desenvolvimento web com Python, aqui na GeHost. Você está prestes a montar um ambiente completo com Django ou Flask, mesmo sem ser especialista. Vou te guiar passo a passo, com carinho, como se fosse um amigo ensinando no seu lado. Vamos lá?
Antes de começar: o que você precisa saber
Na GeHost, você pode rodar aplicativos Python com Django ou Flask usando o Python Web Application — uma ferramenta integrada ao cPanel. Isso significa que você não precisa instalar nada manualmente. Basta seguir os passos abaixo.
Dica do Sensei: Seu site vai rodar em um ambiente seguro, com acesso controlado, e você pode usar o mesmo domínio do seu site principal. Sem complicação!
Passo 1: Acesse o cPanel
Primeiro, faça login no seu painel de controle da GeHost. Use o link que você recebeu por e-mail ou acesse https://cpanel.gehost.com.br.
Insira seu usuário e senha — os mesmos que você usa para o e-mail — e clique em Log in.
Passo 2: Encontre a ferramenta Python
Depois de entrar no cPanel, olhe na seção “Software” (ou “Aplicativos”) e clique em “Python Web Applications”.
Essa é a sua porta de entrada para configurar qualquer aplicativo Python.
Passo 3: Crie um novo ambiente Python
Clique em “Add New Application” (Adicionar Nova Aplicação).
- Escolha a versão do Python que deseja usar. Recomendamos Python 3.11 ou 3.12 — as mais estáveis e compatíveis com Django e Flask.
- Defina o Nome do Aplicativo. Por exemplo:
meu_site_djangoouapi_flask. - Selecione o diretório onde o projeto será instalado. Use
/public_html/meu_site_django(ou o caminho que preferir dentro depublic_html). - Marque a opção “Create a virtual environment” (criar ambiente virtual). Isso é essencial para evitar conflitos entre pacotes.
Dica do Sensei: O ambiente virtual isola suas bibliotecas. Assim, o Django ou Flask não interfere no resto do sistema. É como ter uma caixinha separada para cada projeto!
Passo 4: Instale o Django ou Flask
Após criar o ambiente, clique em “Install Package” (Instalar Pacote).
- Se for Django, digite:
django - Se for Flask, digite:
flask
Selecione a versão desejada (a mais recente é geralmente a melhor) e clique em Install.
Pronto! O framework está instalado no seu ambiente. Você pode verificar isso no painel, onde aparecerá como “Installed”.
Passo 5: Faça upload do seu projeto
Use o Gerenciador de Arquivos para subir seus arquivos.
- Volte ao cPanel e clique em “File Manager”.
- Selecione o diretório onde você criou o aplicativo (ex:
public_html/meu_site_django). - Arraste e solte seus arquivos (arquivos
.py,settings.py,manage.py,app.py, etc.) para dentro dessa pasta.
Dica do Sensei: Se você não tem um projeto pronto, use o comando
django-admin startproject meu_projetono terminal local, depois faça o upload do diretório inteiro.
Passo 6: Configure o arquivo de início (WSGI ou Flask)
O servidor precisa saber qual arquivo iniciar. Isso é feito com um arquivo chamado wsgi.py (para Django) ou app.py (para Flask).
Se for Django, certifique-se de que o arquivo wsgi.py está no diretório raiz do seu projeto e contém:
import os
from django.core.wsgi import get_wsgi_application
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'meu_projeto.settings')
application = get_wsgi_application()
Se for Flask, seu arquivo app.py deve conter algo como:
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello():
return "Olá, mundo! 🌍"
if __name__ == '__main__':
app.run()
Passo 7: Ative o aplicativo
Volte ao painel “Python Web Applications” e clique em “Manage Application” (Gerenciar Aplicação).
Selecione o aplicativo que você criou e clique em “Enable” (Ativar).
Pronto! Seu site agora está ativo na internet.
Passo 8: Teste o seu site
Agora, abra seu navegador e vá para seudominio.com.br/meu_site_django (ou o caminho que você escolheu).
Se tudo estiver certo, você verá a mensagem de boas-vindas do Django ou o "Olá, mundo!" do Flask.
Dica do Sensei: Se aparecer um erro 500, verifique os logs no cPanel em “Metrics” → “Error Logs”. Lá você encontra mensagens que ajudam a corrigir o problema.
Conclusão: Você é um herói agora!
Parabéns, você acabou de configurar um ambiente Python completo na GeHost! Agora, seu site com Django ou Flask está no ar, pronto para crescer, ser atualizado e receber visitantes.
Se precisar de ajuda, lembre-se: estamos aqui. Basta entrar em contato com nosso suporte — com um sorriso no coração, como quem sabe que cada erro é uma lição.
Até a próxima, desenvolvedor(a) corajoso(a)!
