.env.example

# =============================================================================
# Craftplan — Environment Configuration
# =============================================================================
# Copy this file to .env and fill in the required values.
#
#   cp .env.example .env
#
# Works with both docker-compose.yml (pre-built image) and standalone docker run.
# Then generate the secrets below before starting the app.

# -----------------------------------------------------------------------------
# Required Secrets
# -----------------------------------------------------------------------------

# Phoenix secret key (min 64 bytes). Generate with:
#   openssl rand -base64 48
SECRET_KEY_BASE=

# Token signing secret for API authentication. Generate with:
#   openssl rand -base64 48
TOKEN_SIGNING_SECRET=

# Cloak encryption key (32-byte AES key, base64-encoded). Generate with:
#   openssl rand -base64 32
CLOAK_KEY=

# PostgreSQL password for the bundled database container.
POSTGRES_PASSWORD=

# -----------------------------------------------------------------------------
# Host & Networking
# -----------------------------------------------------------------------------

# The public hostname of your Craftplan instance (used for URLs, CORS, etc.)
HOST=localhost

# Port the web server listens on (default: 4000)
PORT=4000

# -----------------------------------------------------------------------------
# File Storage (S3 / MinIO)
# -----------------------------------------------------------------------------
# The bundled MinIO service works out of the box with the defaults below.
# To use an external S3 provider, set these values accordingly.

# MINIO_ROOT_USER=minioadmin
# MINIO_ROOT_PASSWORD=minioadmin
# AWS_S3_BUCKET=craftplan

# For external S3 (uncomment and set):
# AWS_ACCESS_KEY_ID=
# AWS_SECRET_ACCESS_KEY=
# AWS_S3_SCHEME=https://
# AWS_S3_HOST=s3.amazonaws.com
# AWS_REGION=us-east-1
# AWS_ASSET_HOST=https://your-bucket.s3.amazonaws.com

# -----------------------------------------------------------------------------
# Email (Optional)
# -----------------------------------------------------------------------------
# Email is primarily configured from the Settings UI inside the app.
# These environment variables are a fallback for automated/headless setups.
#
# Supported providers: sendgrid, postmark, brevo, mailgun, amazon_ses
#
# EMAIL_PROVIDER=
# EMAIL_API_KEY=
#
# Mailgun only:
# EMAIL_API_DOMAIN=
#
# Amazon SES only:
# EMAIL_API_SECRET=
# EMAIL_API_REGION=us-east-1
#
# SMTP (alternative to API providers):
# SMTP_HOST=
# SMTP_PORT=587
# SMTP_USERNAME=
# SMTP_PASSWORD=