Skip to main content

Requirements

  • Python 3.11+ installed locally
  • Account on Vertra Cloud
  • requirements.txt file at project root

Project Structure

Configuration

requirements.txt

The platform automatically runs pip install -r requirements.txt. Do not include venv or __pycache__ in the upload.

settings.py

Configure your settings.py for production:
Set SECRET_KEY and ALLOWED_HOSTS (your *.vertraweb.app subdomain and any custom domain, separated by commas) in the application’s environment variables before the first deploy: the app doesn’t start without them.

vertracloud.config

Before deployment, run python manage.py collectstatic --noinput locally to compile static files.

Deploy

  1. Compress the project into a .zip (folders like node_modules, venv and target are removed automatically) or push it to GitHub.
  2. In the dashboard, click New Project and upload the .zip or paste the repository URL.
  3. In Build, check the runtime (Python), the main file (manage.py) and the memory. Start and build commands are under Advanced settings.
  4. Add your environment variables in Environment.
  5. In Network, turn on web publishing so the app gets a *.vertraweb.app address (512 MB of memory or more). The app must listen on port 80.
  6. Review and deploy. Follow the output in the Logs tab.
The full walkthrough is in First deploy.

Available Versions

Notes

  • Production server: Use gunicorn to serve the Django application
  • Static files: Run collectstatic and configure WhiteNoise before deployment
  • Database: Configure psycopg2-binary for PostgreSQL
  • Migrations: Run python manage.py migrate before first deployment
  • Environment variables: Configure SECRET_KEY, database credentials and DEBUG=False
  • Auto-restart: Enabled by default
Last modified on November 1, 2026