App Python

Con un piano Hosting Python la tua app Python (Flask, Django o un'altra app WSGI) gira sul nostro server con gunicorn, con il suo database e il suo Redis. Si gestisce dal pannello: Hosting → nome del sito → Applicazione.

Prima di iniziare

  • Nella cartella dell'app serve il file requirements.txt con le dipendenze, gunicorn compreso.
  • L'app parte con gunicorn: il comando di avvio indica il modulo e l'oggetto WSGI, per esempio gunicorn app:app (file app.py, oggetto app).
  • Porta e numero di processi li impostiamo noi: non scrivere --bind o --workers nel comando di avvio.

Quando il sito nasce trovi un'app iniziale «Sito in costruzione» (app.py e requirements.txt): sostituiscila con la tua.

Caricare l'app

Due modi:

  • FTP: carica i file nella cartella www del sito (FTP). Non caricare la cartella .venv o altri ambienti virtuali: l'ambiente lo creiamo noi.
  • Git: collega il repository (Deploy da Git). A ogni aggiornamento installiamo le dipendenze e riavviamo l'app da soli. Una cartella www con dentro solo l'app iniziale vale come vuota: puoi collegare il repository senza svuotarla.

Installa e avvia

Dopo aver caricato l'app clicca Installa e avvia. Nell'ordine:

  1. creiamo l'ambiente .venv nella cartella www;
  2. installiamo le dipendenze con pip install -r requirements.txt;
  3. controlliamo che gunicorn ci sia e avviamo l'app con il comando di avvio.

Può richiedere qualche minuto: la pagina si aggiorna da sola finché non finisce. Accanto al titolo vedi lo stato dell'app: In esecuzione, In avvio o Ferma. Se l'installazione non riesce, apri Mostra l'output dell'installazione per leggere l'errore di pip.

Ripeti Installa e avvia ogni volta che cambi il requirements.txt (con Git lo facciamo noi).

Versione e comando di avvio

In Versione e avvio:

  • Versione di Python: 3.11, 3.12 o 3.13. Cambiandola l'app si reinstalla da sola con la versione nuova.
  • Comando di avvio: gunicorn modulo:oggetto. Esempi: gunicorn app:app per Flask, gunicorn progetto.wsgi per Django (al posto di progetto il nome del tuo progetto). Sono ammessi lettere, cifre, spazi e i caratteri . _ / : = @ -.

Variabili d'ambiente

In Variabili d'ambiente aggiungi chiavi API e impostazioni: le salviamo nel file .env della cartella www, leggibile solo dal sito. L'app lo legge con il pacchetto python-dotenv:

from dotenv import load_dotenv

load_dotenv()

Ricordati di aggiungere python-dotenv al requirements.txt. Le variabili valgono dal prossimo Riavvia. Un valore non può contenere insieme apici singoli e virgolette (o barre rovesciate).

Database e Redis

Ogni app ha il suo database MySQL (MariaDB) e il suo Redis, già collegati: l'app li riceve come variabili d'ambiente (os.environ).

  • DB_HOST, DB_NAME, DB_USER, DB_PASSWORD
  • REDIS_HOST, REDIS_PORT, REDIS_PASSWORD

Le credenziali del database le trovi anche nel pannello, in Database.

Riavviare

Riavvia fa ripartire l'app, per esempio dopo aver cambiato le variabili d'ambiente.

Se l'app non parte

  • Controlla il comando di avvio: modulo e oggetto devono esistere (con gunicorn app:app serve un file app.py con dentro app).
  • Controlla che gunicorn sia nel requirements.txt.
  • Leggi l'output dell'ultima installazione e il log dell'app, il file logs/python.log del sito, che trovi via FTP o nel pannello in File → File Manager.