Connect Vercel and Neon manually
Learn how to connect a Vercel project to a Neon database manually
This guide describes how to manually connect a Vercel project to a Neon database.
note
For other Vercel integration options, refer to the Neon and Vercel integration overview.
Prerequisites
- A Neon project. If you do not have one, see Create your first project.
- A Vercel account.
- A project deployed to Vercel. If you do not have one, see Creating a project, in the Vercel documentation.
Gather your Neon connection details
You can these details from the Connection Details widget on the Neon Dashboard. Select a branch, a role, and the database you want to connect to. A connection string is constructed for you.
The connection string includes the role name, hostname, and database name. For example:
- role name:
daniel - hostname:
ep-raspy-cherry-95040071.us-east-2.aws.neon.tech - database name:
neondb
Configure project environment variables in Vercel
The environment variables required to connect your application to Neon depend on your application. Some applications use a DATABASE_URL environment variable with a database connection string:
Other applications may use PG* environment variables to define database connection details:
note
Neon uses the default Postgres port, 5432.
To configure the environment variables required by your application:
note
Vercel environment variables can also be configured when you first deploy an application to Vercel.
- Navigate to the Vercel dashboard.
- Select your Vercel project.
- Select Settings.
- Select Environment variables.
- Enter the environment variable name in the Key field and add the value.
- Click Add another if you need to add more variables.
- Select the Vercel environments to which the variable(s) will apply (Production, Preview, Development).
- Click Save.
You must redeploy your application in Vercel for the environment variable settings to take effect.
Need help?
Send a request to support@neon.tech, or join the Neon community forum.