Light
Dark
System
v4latest
v4latest
v3
v2
v1

Connection

There are several ways to provide connection information to a client library.

  • Use projects. This is the recommended approach for local development. Once the project is initialized, all client libraries that are running inside the project directory can auto-discover the project-linked instance, no need for environment variables or hard-coded credentials. Follow the Using projects guide to get started.

  • Set the EDGEDB_DSN environment variable to a valid DSN (connection string). This is the recommended approach in production. A DSN is a connection URL of the form edgedb://user:pass@host:port/database. For a guide to DSNs, see the DSN Specification.

  • Set the EDGEDB_INSTANCE environment variable to a name of a local or remote linked instance. You can create new instances manually with the edgedb instance create command.

  • Explicitly pass a DSN or instance name into the client creation function: edgedb.createClient in JS, edgedb.create_client() in Python, and edgedb.CreateClient in Go.

    Copy
    const client = edgedb.createClient({
      dsn: "edgedb://..."
    });

    Only use this approach in development; it isn’t recommended to include sensitive information hard-coded in your production source code. Use environment variables instead. Different languages, frameworks, cloud hosting providers, and container-based workflows each provide various mechanisms for setting environment variables.

These are the most common ways to connect to an instance, however EdgeDB supports several other options for advanced use cases. For a complete reference on connection configuration, see Reference > Connection Parameters.

Light
Dark
System

We use ChatGPT with additional context from our documentation to answer your questions. Not all answers will be accurate. Please join our Discord if you need more help.