Creare un Progetto

La creazione di un progetto Django è il primo passo concreto per iniziare a sviluppare la tua applicazione web. Django fornisce un comando dedicato che genera automaticamente la struttura di base del progetto con tutti i file necessari.

Creare un Nuovo Progetto

Assicurati di avere l’ambiente virtuale attivo, poi utilizza il comando django-admin startproject:

django-admin startproject miosito

Questo comando crea una directory miosito con la seguente struttura:

miosito/
    manage.py
    miosito/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py

Se vuoi creare il progetto nella directory corrente (senza la cartella contenitore esterna), aggiungi un punto alla fine:

# Crea il progetto nella directory corrente
django-admin startproject miosito .

In questo caso la struttura sarà:

./
    manage.py
    miosito/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py

Struttura Generata

Ecco una panoramica rapida dei file generati:

manage.py: Script di utilità per interagire con il progetto Django dalla riga di comando. Non modificare questo file.
miosito/: Il pacchetto Python del progetto, contenente la configurazione principale.
__init__.py: File vuoto che indica a Python che questa directory è un pacchetto.
settings.py: Configurazione del progetto (database, app installate, middleware, ecc.).
urls.py: Configurazione delle URL del progetto, la “tabella dei contenuti” del sito.
asgi.py: Punto d’ingresso per server ASGI (supporto asincrono).
wsgi.py: Punto d’ingresso per server WSGI (deployment tradizionale).

Il File manage.py

manage.py è lo strumento principale per gestire il progetto. Funziona come django-admin ma con le impostazioni del progetto già configurate:

# Alcuni comandi comuni di manage.py
python manage.py runserver         # Avvia il server di sviluppo
python manage.py migrate           # Applica le migrazioni al database
python manage.py createsuperuser   # Crea un utente amministratore
python manage.py shell             # Apre la shell Python con il contesto Django
python manage.py check             # Verifica problemi nel progetto

Avviare il Server di Sviluppo

Django include un server di sviluppo leggero per testare l’applicazione localmente:

cd miosito
python manage.py runserver

Vedrai un output simile a questo:

Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).
February 06, 2026 - 10:00:00
Django version 5.1, using settings 'miosito.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CTRL-BREAK.

Apri il browser e vai su http://127.0.0.1:8000/ per vedere la pagina di benvenuto di Django.

Personalizzare il Server

Puoi specificare una porta o un indirizzo diverso:

# Cambia la porta
python manage.py runserver 8080

# Ascolta su tutte le interfacce di rete
python manage.py runserver 0.0.0.0:8000

Applicare le Migrazioni Iniziali

Django mostra un avviso sulle migrazioni non applicate. Esegui il comando migrate per creare le tabelle iniziali del database:

python manage.py migrate

Operations to perform:
  Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
  ...

Questo crea un file db.sqlite3 (il database SQLite predefinito) nella directory del progetto.

Creare un Superutente

Per accedere al pannello di amministrazione Django, crea un superutente:

python manage.py createsuperuser

Inserisci username, email e password quando richiesto. Poi vai su http://127.0.0.1:8000/admin/ per accedere al pannello admin.

Conclusione

Hai creato il tuo primo progetto Django e avviato il server di sviluppo. La struttura generata automaticamente fornisce una solida base su cui costruire la tua applicazione. Nel prossimo capitolo analizzeremo in dettaglio ogni file della struttura del progetto.