.env.example

# ─────────────────────────────────────────────────────────────────────────────
# ByteSend — environment variable template
#
# Copy this file to .env and fill in your values.
# Lines beginning with # are comments.
# ─────────────────────────────────────────────────────────────────────────────


# Public URL of your ByteSend instance (must be HTTPS in production)
NEXTAUTH_URL=https://your-domain.com

# Random secret used to sign sessions — generate with: openssl rand -base64 32
NEXTAUTH_SECRET=


DATABASE_URL=postgresql://bytesend:changeme@localhost:5432/bytesend

REDIS_URL=redis://localhost:6379

# Optional: prefix all Redis keys (useful when sharing a Redis instance)
# REDIS_KEY_PREFIX=bytesend:

# Required for sending emails. Create an IAM user with SES permissions.
# See: https://docs.bytesend.cloud/get-started/create-aws-credentials

AWS_ACCESS_KEY=
AWS_SECRET_KEY=
AWS_DEFAULT_REGION=eu-west-1

# Optional: override the SES and SNS endpoints (e.g. for local mocking)
# AWS_SES_ENDPOINT=
# AWS_SNS_ENDPOINT=


# The "from" address used for transactional account emails (magic links etc.)
FROM_EMAIL=noreply@your-domain.com

# Optional: external SMTP relay for transactional account emails.
# Defaults to smtp.bytesend.cloud if not set.
# SMTP_HOST=
# SMTP_USER=

# At least one provider is recommended. All are optional individually.
# If none are configured, users can still sign in via magic-link email.

# GitHub — https://github.com/settings/applications/new
GITHUB_ID=
GITHUB_SECRET=

# Discord — https://discord.com/developers/applications
DISCORD_CLIENT_ID=
DISCORD_CLIENT_SECRET=

# Google — https://console.cloud.google.com/apis/credentials
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

# Works with AWS S3, Cloudflare R2, Backblaze B2, MinIO, etc.

S3_COMPATIBLE_ACCESS_KEY=
S3_COMPATIBLE_SECRET_KEY=
S3_COMPATIBLE_API_URL=
S3_COMPATIBLE_PUBLIC_URL=
S3_COMPATIBLE_BUCKET=bytesend

API_RATE_LIMIT=1
AUTH_EMAIL_RATE_LIMIT=5

# Email address of the super-admin user (grants admin panel access)
ADMIN_EMAIL=