Como Configurar um Ambiente Python com Virtualenv no seu VPS
Oi! Aqui é a Sensei da GeHost 🧡 Se você chegou até aqui, provavelmente quer rodar uma aplicação Python no seu servidor sem bagunçar as bibliotecas do sistema — e é exatamente pra isso que existe o virtualenv. Vou te guiar com calma, passo a passo, mesmo que você nunca tenha usado terminal antes.
O que é um virtualenv e por que usar?
Pense no virtualenv como uma "caixinha isolada" só para o seu projeto Python. Dentro dela, você instala as bibliotecas que o seu projeto precisa, na versão que ele precisa, sem interferir em outros projetos ou no Python do próprio sistema operacional.
💡 Dica da Sensei: misturar bibliotecas de projetos diferentes no mesmo Python "global" é uma das causas mais comuns de erro estranho em produção. Um virtualemv por projeto evita esse tipo de dor de cabeça.
Pré-requisitos
- Acesso ao seu VPS via SSH (usuário e senha, ou chave — confira o que consta no seu contrato/painel).
- Um terminal para conectar (no Windows: PowerShell ou PuTTY; no Mac/Linux: o Terminal já resolve).
Passo 1 — Conecte-se ao servidor
Abra o terminal e conecte via SSH. O comando costuma ser assim (substitua pelos dados do seu servidor):
ssh usuario@seu-servidor
Digite a senha (ou use sua chave, se for o caso) e pronto, você está "dentro" do servidor.
Passo 2 — Confira se o Python está instalado
Rode:
python3 --version
Se aparecer um número de versão (algo como Python 3.x.x), ótimo, já temos Python disponível. Se o comando não for reconhecido, você vai precisar instalar o Python antes de continuar — nesse caso, entre em contato com o suporte para orientação, já que o procedimento pode variar conforme a distribuição do servidor.
Passo 3 — Instale o módulo venv (se necessário)
Em algumas distribuições Linux, o módulo de virtualenv não vem junto com o Python por padrão. Tente rodar o comando do próximo passo primeiro; se der erro reclamando do "venv", pode ser preciso instalá-lo separadamente com o gerenciador de pacotes da sua distribuição. Se tiver dúvida em qual comando usar, fale com o suporte antes de instalar qualquer pacote no sistema.
Passo 4 — Crie o seu virtualenv
Dentro da pasta do seu projeto, rode:
python3 -m venv venv
Isso cria uma pasta chamada venv com uma cópia isolada do Python só para esse projeto. Você pode trocar o nome venv por outro, se preferir.
Passo 5 — Ative o ambiente virtual
Ainda na mesma pasta, ative com:
source venv/bin/activate
Você vai perceber que o nome do ambiente ((venv)) aparece agora no início da linha do terminal. Isso confirma que você está "dentro" da caixinha isolada.
💡 Dica da Sensei: tudo que você instalar com pip a partir de agora fica só dentro desse ambiente — nada afeta o resto do servidor.
Passo 6 — Instale as dependências do seu projeto
Com o ambiente ativado, instale as bibliotecas que sua aplicação precisa. Exemplo:
pip install nome-da-biblioteca
Se o seu projeto já tem um arquivo requirements.txt, basta rodar:
pip install -r requirements.txt
Passo 7 — Rode sua aplicação
Com o ambiente ativo, execute normalmente o seu script, por exemplo:
python meu_projeto.py
Passo 8 — Saindo do ambiente
Quando terminar de trabalhar, é só desativar o ambiente com:
deactivate
O (venv) some do terminal e você volta ao Python "normal" do sistema.
Dicas finais
- Crie um virtualenv diferente para cada projeto — isso evita conflitos de versão entre bibliotecas.
- Nunca suba a pasta
venvpara o controle de versão (Git); ela pode ser recriada a qualquer momento com os passos acima. - Se algo não funcionar como esperado, respire fundo, revise o passo a passo com calma e, se precisar, chame o suporte da GeHost — estamos aqui pra ajudar. 🧡
💡 Dica da Sensei: qualquer dúvida sobre limites, permissões ou recursos disponíveis no seu plano, o caminho mais seguro é sempre conferir direto no painel do cliente ou falar com o suporte, já que cada contratação pode ter particularidades.
