Neon raises $30M in Series A-1Read More

Setting Up a Project

To set up a Neon project:

  1. Navigate to the Projects page in the Neon Console.

  2. If you are creating your very first project, click Create the first project. Otherwise, click New Project.

  3. Enter a name for your project and click Create Project. Upon creating a project, you are presented with a dialog that provides the following information:

    • A generated password for the project

    • An export command that you can use to export your project password to a PGPASSWORD environment variable:

      export PGPASSWORD=<password>

    • Commands for adding your password to .pgpass; for example:

    touch ~/.pgpass && \
    chmod 0600 ~/.pgpass && \
    echo -e "<username>:<password>\n$(cat ~/.pgpass)" > ~/.pgpass

For information about connecting to Neon using psql, see Querying with psql.

Important: After the dialog containing your project's password information is closed, it is no longer accessible. If you forget or misplace your password, your only option is to reset it. You can reset a password on the User page, which is found on the Settings tab in the Neon Console.

Creating a Neon project automatically creates a Neon compute instance. For the Technical Preview, a Neon compute instance is deployed with PostgreSQL 14.5, 1 vCPU, and 256MB of RAM. For more information about limits associated with the Technical Preview, see Technical Preview Free Tier.

Each Neon project is created with a default database named main, which resides in the public schema.

You can query a Neon project database from the Neon SQL Editor or a psql client. For instructions, see:

For information about connecting to a Neon project from an application, refer to The Integrations section in the Neon documentation,

All operations supported by the Neon Console can also be performed with the Neon API. Using the Neon API requires an API key. For instructions, see Using API Keys.