Portabase DashboardInstallation
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 | Optional | Default | Description |
|---|---|---|---|---|
PROJECT_URL | string | No | http://localhost:8887 | Public URL of your dashboard (e.g. https://backups.my-domain.com). Important for generated links. |
PROJECT_SECRET | string | No | None | Critical. Secret used to encrypt sensitive data. Generate with openssl rand -hex 32. |
PROJECT_NAME | string | Yes | Portabase | Display name in the UI (site title). |
RETENTION_CRON | string | Yes | 0 7 * * * | Schedule for automatic deletion of backups according to the retention policies. |
Database
Configuration for the internal Portabase PostgreSQL connection.
| Variable | Type | Optional | Default | Description |
|---|---|---|---|---|
DATABASE_URL | string | Yes | None | Database URL (e.g., postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${POSTGRES_HOST}:${POSTGRES_PORT}/${POSTGRES_DB}?schema=public). If not specified, the internal database will be used. |
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 |