Como configurar um ambiente Python com virtualenv em um VPS

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 venv para 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.