Task/support DIRECT_URL for Prisma CLI and seeding to support connection poolers (#6882)

* Add support for DIRECT_URL

* Update changelog

.config/prisma.ts

@@ -7,7 +7,7 @@ expand(config({ quiet: true }));
 
 export default defineConfig({
   datasource: {
-    url: process.env.DATABASE_URL ?? ''
+    url: process.env.DIRECT_URL ?? process.env.DATABASE_URL
   },
   migrations: {
     path: join(__dirname, '..', 'prisma', 'migrations'),

CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+### Added
+
+- Added support for the `DIRECT_URL` environment variable to enable direct database connections
+
 ### Changed
 
 - Improved the pagination in the activities table of the holding detail dialog

README.md

@@ -86,11 +86,12 @@ We provide official container images hosted on [Docker Hub](https://hub.docker.c
 ### Supported Environment Variables
 
 | Name                        | Type                  | Default Value         | Description                                                                                                                                                                            |
-| --------------------------- | --------------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| --------------------------- | --------------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `ACCESS_TOKEN_SALT`         | `string`              |                       | A random string used as salt for access tokens                                                                                                                                         |
 | `API_KEY_COINGECKO_DEMO`    | `string` (optional)   |                       | The _CoinGecko_ Demo API key                                                                                                                                                           |
 | `API_KEY_COINGECKO_PRO`     | `string` (optional)   |                       | The _CoinGecko_ Pro API key                                                                                                                                                            |
-| `DATABASE_URL`              | `string`              |                       | The database connection URL, e.g. `postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@localhost:5432/${POSTGRES_DB}` |
+| `DATABASE_URL`              | `string`              |                       | The database connection URL. If using a connection pooler, use the pooled connection URL here. e.g. `postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@localhost:5432/${POSTGRES_DB}` |
+| `DIRECT_URL`                | `string` (optional)   |                       | The direct database connection URL used by the _Prisma CLI_ (e.g. for schema migrations) and seeding, bypassing any connection poolers (falls back to `DATABASE_URL`)                  |
 | `ENABLE_FEATURE_AUTH_TOKEN` | `boolean` (optional)  | `true`                | Enables authentication via security token                                                                                                                                              |
 | `HOST`                      | `string` (optional)   | `0.0.0.0`             | The host where the Ghostfolio application will run on                                                                                                                                  |
 | `JWT_SECRET_KEY`            | `string`              |                       | A random string used for _JSON Web Tokens_ (JWT)                                                                                                                                       |

prisma/seed.mts

@@ -2,7 +2,7 @@ import { PrismaPg } from '@prisma/adapter-pg';
 import { PrismaClient } from '@prisma/client';
 
 const adapter = new PrismaPg({
-  connectionString: process.env.DATABASE_URL
+  connectionString: process.env.DIRECT_URL ?? process.env.DATABASE_URL
 });
 
 const prisma = new PrismaClient({ adapter });