DEV Community

Cover image for Setup Django in Debian

Setup Django in Debian

1️⃣ Atualizar o sistema

sudo apt update && sudo apt upgrade -y
Enter fullscreen mode Exit fullscreen mode

2️⃣ Instalar dependências básicas

sudo apt install -y python3 python3-pip python3-venv build-essential libssl-dev libffi-dev python3-dev git curl
Enter fullscreen mode Exit fullscreen mode

Isso garante Python 3, pip, compiladores e libs necessárias para pacotes Python que usam C.


3️⃣ Criar um ambiente virtual (recomendado)

mkdir ~/meu_projeto
cd ~/meu_projeto
python3 -m venv venv
source venv/bin/activate
Enter fullscreen mode Exit fullscreen mode

Sempre ative o ambiente virtual antes de instalar pacotes.

Para desativar:

deactivate
Enter fullscreen mode Exit fullscreen mode

4️⃣ Atualizar pip e instalar Django

pip install --upgrade pip
pip install django
Enter fullscreen mode Exit fullscreen mode

Verificar versão:

django-admin --version
Enter fullscreen mode Exit fullscreen mode

5️⃣ Criar um projeto Django

django-admin startproject meu_projeto .
Enter fullscreen mode Exit fullscreen mode

O ponto . cria o projeto na pasta atual.


6️⃣ Configurar banco de dados (opcional)

Por padrão o Django usa SQLite, que funciona bem para desenvolvimento.

Se quiser usar PostgreSQL (recomendado para produção):

sudo apt install -y postgresql postgresql-contrib libpq-dev
Enter fullscreen mode Exit fullscreen mode

Criar usuário e banco:

sudo -u postgres createuser meu_usuario -P
sudo -u postgres createdb meu_banco -O meu_usuario
Enter fullscreen mode Exit fullscreen mode

Instalar driver Python:

pip install psycopg2-binary
Enter fullscreen mode Exit fullscreen mode

Configurar settings.py:

# meu_projeto/settings.py
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'meu_banco',
        'USER': 'meu_usuario',
        'PASSWORD': 'sua_senha',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}
Enter fullscreen mode Exit fullscreen mode

7️⃣ Aplicar migrações iniciais

python manage.py migrate
Enter fullscreen mode Exit fullscreen mode

8️⃣ Criar usuário admin

python manage.py createsuperuser
Enter fullscreen mode Exit fullscreen mode

Siga as instruções (nome, email, senha).


9️⃣ Testar servidor de desenvolvimento

python manage.py runserver
Enter fullscreen mode Exit fullscreen mode

Acesse no navegador:

http://127.0.0.1:8000/
Enter fullscreen mode Exit fullscreen mode

Admin:

http://127.0.0.1:8000/admin/
Enter fullscreen mode Exit fullscreen mode

🔟 Configurar Django REST Framework (opcional)

Se quiser criar APIs:

pip install djangorestframework
Enter fullscreen mode Exit fullscreen mode

Adicionar ao settings.py:

INSTALLED_APPS = [
    ...
    'rest_framework',
]
Enter fullscreen mode Exit fullscreen mode

1️⃣1️⃣ Dicas extras

  • Para ambiente de produção, use Gunicorn + Nginx.
  • Use .env com python-decouple para variáveis sensíveis.
  • Sempre ative o virtualenv antes de rodar o projeto.

Top comments (0)