Setup Django in Debian

1️⃣ Atualizar o sistema

sudo apt update && sudo apt upgrade -y 

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 

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 

Sempre ative o ambiente virtual antes de instalar pacotes.

Para desativar:

deactivate 

4️⃣ Atualizar pip e instalar Django

pip install --upgrade pip pip install django 

Verificar versão:

django-admin --version 

5️⃣ Criar um projeto Django

django-admin startproject meu_projeto . 

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 

Criar usuário e banco:

sudo -u postgres createuser meu_usuario -P sudo -u postgres createdb meu_banco -O meu_usuario 

Instalar driver Python:

pip install psycopg2-binary 

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', } } 

7️⃣ Aplicar migrações iniciais

python manage.py migrate 

8️⃣ Criar usuário admin

python manage.py createsuperuser 

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

9️⃣ Testar servidor de desenvolvimento

python manage.py runserver 

Acesse no navegador:

http://127.0.0.1:8000/ 

Admin:

http://127.0.0.1:8000/admin/ 

🔟 Configurar Django REST Framework (opcional)

Se quiser criar APIs:

pip install djangorestframework 

Adicionar ao settings.py:

INSTALLED_APPS = [ ... 'rest_framework', ] 

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.