Setup Django in Debian

This content originally appeared on DEV Community and was authored by Rômulo Mendes Soares Junior

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.

This content originally appeared on DEV Community and was authored by Rômulo Mendes Soares Junior