https://github.com/tooniez/django-vercel
📚 A Django application hosted on Vercel
https://github.com/tooniez/django-vercel
django python vercel
Last synced: 2 months ago
JSON representation
📚 A Django application hosted on Vercel
- Host: GitHub
- URL: https://github.com/tooniez/django-vercel
- Owner: tooniez
- Created: 2024-09-06T01:55:51.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-06-06T23:25:38.000Z (about 1 year ago)
- Last Synced: 2025-07-20T08:29:19.507Z (11 months ago)
- Topics: django, python, vercel
- Language: Python
- Homepage: https://django-vercel-one-chi.vercel.app
- Size: 15.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Fexamples%2Ftree%2Fmain%2Fpython%2Fdjango&demo-title=Django%20%2B%20Vercel&demo-description=Use%20Django%204%20on%20Vercel%20with%20Serverless%20Functions%20using%20the%20Python%20Runtime.&demo-url=https%3A%2F%2Fdjango-template.vercel.app%2F&demo-image=https://assets.vercel.com/image/upload/v1669994241/random/django.png)
# Django + Vercel
This example shows how to use Django 4 on Vercel with Serverless Functions using the [Python Runtime](https://vercel.com/docs/concepts/functions/serverless-functions/runtimes/python).
## Demo
https://django-template.vercel.app/
## How it Works
Our Django application, `example` is configured as an installed application in `api/settings.py`:
```python
# api/settings.py
INSTALLED_APPS = [
# ...
'example',
]
```
We allow "\*.vercel.app" subdomains in `ALLOWED_HOSTS`, in addition to 127.0.0.1:
```python
# api/settings.py
ALLOWED_HOSTS = ['127.0.0.1', '.vercel.app']
```
The `wsgi` module must use a public variable named `app` to expose the WSGI application:
```python
# api/wsgi.py
app = get_wsgi_application()
```
The corresponding `WSGI_APPLICATION` setting is configured to use the `app` variable from the `api.wsgi` module:
```python
# api/settings.py
WSGI_APPLICATION = 'api.wsgi.app'
```
There is a single view which renders the current time in `example/views.py`:
```python
# example/views.py
from datetime import datetime
from django.http import HttpResponse
def index(request):
now = datetime.now()
html = f'''
Hello from Vercel!
The current time is { now }.
'''
return HttpResponse(html)
```
This view is exposed a URL through `example/urls.py`:
```python
# example/urls.py
from django.urls import path
from example.views import index
urlpatterns = [
path('', index),
]
```
Finally, it's made accessible to the Django server inside `api/urls.py`:
```python
# api/urls.py
from django.urls import path, include
urlpatterns = [
...
path('', include('example.urls')),
]
```
This example uses the Web Server Gateway Interface (WSGI) with Django to enable handling requests on Vercel with Serverless Functions.
## Running Locally
```bash
python manage.py runserver
```
Your Django application is now available at `http://localhost:8000`.
## One-Click Deploy
Deploy the example using [Vercel](https://vercel.com?utm_source=github&utm_medium=readme&utm_campaign=vercel-examples):
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Fexamples%2Ftree%2Fmain%2Fpython%2Fdjango&demo-title=Django%20%2B%20Vercel&demo-description=Use%20Django%204%20on%20Vercel%20with%20Serverless%20Functions%20using%20the%20Python%20Runtime.&demo-url=https%3A%2F%2Fdjango-template.vercel.app%2F&demo-image=https://assets.vercel.com/image/upload/v1669994241/random/django.png)