Environment Variables

Portabase provides flexibility through environment variables. These let you customize application behavior, database connection, authentication and storage.

If you use Docker Compose, set these variables in your .env file at the root of the Dashboard project.

Database

Configuration for the internal Portabase PostgreSQL connection.

Variable	Type	Default	Description
`DATABASE_URL`	`string`	`postgresql://devuser:changeme@db:5432/devdb?schema=public`	Full connection string used by the app (Prisma).
`POSTGRES_DB`	`string`	`devdb`	Database name.
`POSTGRES_USER`	`string`	`devuser`	PostgreSQL user.
`POSTGRES_PASSWORD`	`string`	`changeme`	User password.

Project

General instance configuration.

Variable	Type	Default	Description
`PROJECT_NAME`	`string`	`Portabase`	Display name in the UI (site title).
`PROJECT_DESCRIPTION`	`string`	`Manage all your database instances from one place !`	Project tagline or description.
`PROJECT_URL`	`string`	`http://localhost:8887`	Public URL of your dashboard (e.g. `https://backup.my-site.com`). Important for generated links.
`PROJECT_SECRET`	`string`	`None`	Critical. Secret used to encrypt sensitive data. Generate with `openssl rand -hex 32`.
`TIME_ZONE`	`string`	`Europe/Paris`	Application timezone.

Security

Never change PROJECT_SECRET once in production, otherwise you will not be able to decrypt agent keys.

Email (SMTP)

Configuration for transactional email delivery (alerts, invitations).

Variable	Type	Default	Description
`SMTP_HOST`	`string`	`None`	SMTP server address (e.g. `smtp.resend.com`).
`SMTP_PORT`	`string`	`None`	SMTP server port (e.g. `587`).
`SMTP_USER`	`string`	`None`	SMTP username.
`SMTP_PASSWORD`	`string`	`None`	SMTP password.
`SMTP_FROM`	`string`	`None`	From email address (e.g. `no-reply@your-domain.com`).

Google Authentication (OAuth)

Enable login via Google (SSO).

Variable	Type	Default	Description
`AUTH_GOOGLE_METHOD`	`string`	`false`	Enable (`true`) or disable (`false`) the Google provider.
`AUTH_GOOGLE_ID`	`string`	`None`	Your Google Cloud Client ID.
`AUTH_GOOGLE_SECRET`	`string`	`None`	Your Google Cloud Client Secret.

Storage

Configuration for backup storage (local or S3-compatible object storage).

Variable	Type	Default	Description
`STORAGE_TYPE`	`string`	`local`	Storage type: `local` (server disk) or `s3` (cloud).
`S3_ENDPOINT`	`string`	`api.s3.portabase.exemple.com`	S3 endpoint URL (e.g. `s3.fr-par.scw.cloud`).
`S3_ACCESS_KEY`	`string`	`None`	S3 access key.
`S3_SECRET_KEY`	`string`	`None`	S3 secret key.
`S3_BUCKET_NAME`	`string`	`None`	Destination bucket name.
`S3_PORT`	`string`	`9000`	S3 service port (usually 443 for HTTPS, 9000 for MinIO).
`S3_USE_SSL`	`string`	`false`	Use HTTPS (`true`) or HTTP (`false`).