# Python-apps: Django, Flask en FastAPI

> De Python-versie en hoe je die wisselt, dependencies met pip, startcommando’s voor Django, Flask en FastAPI, en de PORT die we je geven.

Source: https://veldhost.eu/nl/docs/python-apps

Last verified: 2026-11-21

Een Python-site draait je eigen Python-webapp: Django, Flask, FastAPI, Starlette of iets anders dat HTTP op een poort serveert. Wij installeren de dependencies in een eigen virtuele omgeving, starten de app als bewaakte service en zetten nginx ervoor. Dit artikel beschrijft wat je app moet doen, en wat wij ervoor doen.

## Hoe het draait

- **Python 3.12, 3.13, 3.14 en 3.15**, te wisselen op de sitepagina onder **Configure** → **Python version**: kies een versie onder **Run on** en klik op **Switch**. Elke versie draait altijd de nieuwste release (de lijst toont die exact, zoals *Python 3.14.10*); verschijnt er een nieuwere patch, dan herstart je app er dezelfde nacht op.
- Elke versie heeft een eigen virtuele omgeving, en die blijft bewaard. Bij het wisselen installeren we eerst je dependencies in de omgeving van de nieuwe versie en herstarten we pas daarna je app erop, meestal binnen een paar minuten; tot dan blijft je site antwoorden op de oude versie. Mislukt de installatie, dan blijft je app op de versie die hij had. Terugwisselen naar een versie die je eerder gebruikte gaat snel: de omgeving staat er nog.
- Je app wordt door de servicemanager van het systeem gestart als eigen gebruiker, herstart als hij crasht, en krijgt een geheugenlimiet die bij je abonnement past.
- nginx luistert aan de buitenkant. Alles in de map `public/` van je project wordt direct van schijf geserveerd; elk ander verzoek gaat naar je app.
- TLS, je domein, back-ups en monitoring werken zoals bij elke andere site.

## Dependencies

Bij elke deploy, elke versiewissel en elke start controleren we je dependencies en installeren we ze met pip in de virtuele omgeving van de site als ze zijn veranderd (een ongewijzigde lijst wordt niet opnieuw geïnstalleerd, dus herstarten blijft snel):

- `uv.lock` (met zijn `pyproject.toml`) in de hoofdmap van je project: [uv](https://docs.astral.sh/uv/) installeert precies de vastgelegde set (`uv sync --frozen --no-dev`): ontwikkel-dependencies blijven weg en er wordt niets stiekem bijgewerkt. Je project zelf wordt ook geïnstalleerd als zijn `pyproject.toml` een build-systeem opgeeft;
- anders `requirements.txt`: `pip install -r requirements.txt`;
- anders `pyproject.toml`: de pakketten onder `[project]` `dependencies`. Je project zelf wordt niet als pakket gebouwd, dus een app die alleen een map met modules is werkt ook.

Pin je versies (een gecommitte `uv.lock`, of `Django==5.2.*` in `requirements.txt`), zodat een deploy installeert wat je hebt getest. Een `uv.lock` die niet meer bij `pyproject.toml` past laat de deploy mislukken: draai `uv lock` en push opnieuw. Pakketten met gecompileerde delen installeren vanuit wheels; heeft er een nog geen wheel voor jouw Python-versie, wissel dan naar de versie ervoor.

## Deployen

Koppel een repository op het tabblad **Deploys** van de site onder **Deploy from Git** (zie [Deploy from Git](https://veldhost.eu/docs/deploy-from-git)). Bij elke deploy kopiëren we je project naar je site, installeren we de dependencies zoals hierboven, herstarten we je app en wachten we tot hij op zijn poort antwoordt. Een kapot startcommando of een ontbrekende dependency laat de deploy mislukken, en het deploylog zegt waarom. **Install & restart** op het tabblad Deploys doet dezelfde installatie en herstart op de code die al op je site staat.

**Django-migraties draaien we voor je.** Heeft je project een `manage.py`, dan draait elke deploy `python manage.py migrate --noinput` met de omgevingsvariabelen van je site, nadat de nieuwe dependencies zijn geïnstalleerd en voordat je app op de nieuwe code herstart. We maken eerst een back-up van de sitedatabase (de laatste vijf kopieën blijven bewaard). Een mislukte migratie stopt de deploy, je app blijft draaien zoals hij was, en het deploylog toont de fout. De schakelaar voor databasemigraties onder **Build steps** op het tabblad Deploys zet dit uit. Met [release-goedkeuring](https://veldhost.eu/docs/release-approval-and-rollback) aan wachten de migraties met de release op de goedkeuring. Andere frameworks: draai de jouwe vanuit het startcommando (`alembic upgrade head && uvicorn main:app --host 127.0.0.1 --port $PORT`) of via [SSH](https://veldhost.eu/docs/ssh-sftp-access).

## Het startcommando

Laat **Start command** leeg en we leiden het af uit je project, in deze volgorde:

1. een `Procfile` met een `web:`-regel;
2. Django: `manage.py` plus een `<project>/wsgi.py`, met gunicorn geïnstalleerd — `gunicorn <project>.wsgi`;
3. FastAPI: `main.py` die `FastAPI(...)` aanmaakt, met uvicorn geïnstalleerd — `uvicorn main:app`;
4. Flask: `app.py` die `Flask(...)` aanmaakt, met gunicorn geïnstalleerd — `gunicorn app:app`;
5. `python main.py` of `python app.py`;
6. anders een tijdelijke pagina, tot je deployt.

Heeft je app iets anders nodig, zet het dan op de sitepagina onder **Configure** → **Python version** → **Start command** en klik op **Save**. Laat het leeg om terug te gaan naar de detectie.

| Framework | Toevoegen aan je dependencies | Startcommando |
| --- | --- | --- |
| Django | `gunicorn` | `gunicorn mysite.wsgi --bind 127.0.0.1:$PORT` |
| Flask | `gunicorn` | `gunicorn app:app --bind 127.0.0.1:$PORT` |
| FastAPI | `uvicorn` | `uvicorn main:app --host 127.0.0.1 --port $PORT` |
| Iets anders | | `python main.py` (dat zelf `PORT` leest) |

Het commando draait vanuit de hoofdmap van je project, met de virtuele omgeving van je site vooraan op het `PATH`, dus `python`, `gunicorn` en `uvicorn` zijn de versies die jij hebt geïnstalleerd. Aanhalingstekens zijn niet toegestaan.

## De omgevingsvariabele PORT

Je app **moet luisteren op de poort in de omgevingsvariabele `PORT`**, op `127.0.0.1`: nginx verbindt er lokaal mee. gunicorn en uvicorn krijgen hem zoals hierboven; in gewoon Python lees je `os.environ["PORT"]`. We zetten ook `PYTHONUNBUFFERED=1`, zodat wat je app print meteen in de logs staat.

Voeg je eigen variabelen (geheime sleutels, API-sleutels) toe onder **Configure** → **Environment variables**; je app wordt herstart zodat hij ze oppikt. `PORT` is altijd van ons. Heeft je site een beheerde database, dan staan de `DB_*`-variabelen al klaar: lees ze met `os.environ["DB_HOST"]` en verwanten.

## Achter een proxy

Verzoeken komen via gewoon HTTP van nginx bij je app, met de echte gegevens in headers: `X-Forwarded-Proto` (`https`), `X-Forwarded-For` en `X-Forwarded-Host`. Laat je framework ze vertrouwen, zodat het `https://`-links maakt: in Django `SECURE_PROXY_SSL_HEADER = ("HTTP_X_FORWARDED_PROTO", "https")` en je domein in `ALLOWED_HOSTS`; in Flask werkzeugs `ProxyFix`; met uvicorn `--proxy-headers`.

## Als er iets misgaat

Het [tabblad Logs](https://veldhost.eu/docs/site-logs) toont de eigen uitvoer van je app, dus een mislukte start zie je snel. Veelvoorkomende oorzaken: de app luistert op een vaste poort in plaats van `PORT`, gunicorn of uvicorn ontbreekt in je dependencies, of een pakket heeft geen build voor de Python-versie waarnaar je wisselde. Herstel, push, deploy opnieuw.

## Gerelateerd

- [Deploy from Git](https://veldhost.eu/docs/deploy-from-git)
- [Omgevingsvariabelen](https://veldhost.eu/docs/environment-variables)
- [Node.js- en Bun-apps](https://veldhost.eu/docs/node-apps)
- [Site-logs](https://veldhost.eu/docs/site-logs)