Portabase DashboardAdvanced Configuration
Environment Variables
Complete reference of .env configuration options.
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 project.
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://backups.my-domain.com). Important for generated links. |
PROJECT_SECRET | string | None | Critical. Secret used to encrypt sensitive data. Generate with openssl rand -hex 32. |
RETENTION_CRON | string | 0 7 * * * | Schedule for automatic deletion of backups according to the retention policies. |
Database
Configuration for the internal Portabase PostgreSQL connection.
| Variable | Type | Default | Description |
|---|---|---|---|
POSTGRES_DB | string | devdb | Database name. |
POSTGRES_USER | string | devuser | PostgreSQL user. |
POSTGRES_PASSWORD | string | changeme | User password. |
DATABASE_URL | string | postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@db:5432/${POSTGRES_DB}?schema=public | Full connection string used by the app. |
Email (SMTP)
Configuration for transactional email delivery (alerts, invitations).
If no configuration is provided, email-related features will be limited (no password reset, no email verification).
| 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). |
SMTP_SECURE | string | false |
Google Authentication (OAuth2)
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 OAuth2 Client ID. |
AUTH_GOOGLE_SECRET | string | None | Your Google Cloud OAuth2 Client Secret. |