Register for Neon Developer Days 🚀Read More

Connect a Django application to Neon

This guide describes how to create a Neon project and connect to it from a Django application.

To connect to Neon from a Django application:

  1. Create a Neon project
  2. Configure Django connection settings

Create a Neon project

When creating a Neon project, take note of your endpoint hostname, user name, and password. This information is required when defining connection settings in your Django project.

To create a Neon project:

  1. Navigate to the Projects page in the Neon Console.
  2. Click New Project.
  3. Specify a name, a PostgreSQL version, a region, and click Create Project.

For additional information about creating projects, see Setting up a project.

Configure Django connection settings

Connecting to Neon requires configuring database connection settings in your Django project's file.

In your Django project, navigate to the DATABASES section of your file and modify the connection details as shown:

    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': '<dbname>',
        'USER': '<user>',
        'PASSWORD': '<password>',
        'HOST': '<endpoint_hostname>',
        'PORT': '5432',


  • <dbname> is the database you are connecting to. The default Neon database is main.
  • <user> is the database user, which is found on the Neon Dashboard, under Connection Details.
  • <password> is the database user's password, which is provided to you when you create a project.
  • <endpoint_hostname> is the hostname of the branch endpoint, which is found on the Neon Dashboard, under Connection Settings.

For additional information about Django project settings, see Django Settings: Databases, in the Django documentation.


Running Django tests is currently not supported. The Django test runner must be able to create a database for tests, which is not yet supported by Neon.

Edit this page
Was this page helpful?