.env.example

# ------------------------------------------------------------
# 自托管配置（Renewlet Go + Vite + PocketBase）
# ------------------------------------------------------------

# 对外端口；容器内固定监听 3000。
PORT="3000"

# Go 运行时软内存上限。低内存机器建议保持 128MiB，容器上限先给 256m。
GOMEMLIMIT="128MiB"
MEM_LIMIT="256m"

# 容器时区，仅影响日志和少量本地时间展示；业务时间仍以用户设置为准。
TZ="Asia/Shanghai"

# 可选：Docker/Go 服务端主动访问上游 HTTP(S) 服务时使用的代理。
# 覆盖范围包括通知渠道、AI provider、GitHub Release/图标索引、WebDAV/S3 云备份等 HTTP 请求。
# 注意：容器内的 127.0.0.1/localhost 指向容器自身；宿主机代理请填写容器可访问的地址。
# 推荐写法：使用大写变量。
# HTTP_PROXY="http://host.docker.internal:7890"
# HTTPS_PROXY="http://host.docker.internal:7890"
# NO_PROXY="localhost,127.0.0.1,.local"
# 备选写法：也支持小写变量；不要同时配置两组，同时存在时 Go 优先读取大写。
# http_proxy="http://host.docker.internal:7890"
# https_proxy="http://host.docker.internal:7890"
# no_proxy="localhost,127.0.0.1,.local"

# 对外访问地址，用于 PocketBase 邮件链接。
APP_URL="http://localhost:3000"

# 可选：标准 Docker Demo Mode。开启后使用固定 demo 账号登录，数据启动时和每 2 小时重置一次。
# Demo 登录：demo@renewlet.local / renewlet-demo
RENEWLET_DEMO_MODE="false"

# 可选：部署者可信的原始 <head> HTML 片段，UTF-8 最大 64 KiB；不需要时保持为空。
# Docker/Go 在进程启动时冻结；Vite dev 在启动时读取，Cloudflare Static Assets 在构建时读取。
# 片段拥有页面同源代码权限；启用后 CSP 切换为可信扩展策略，部署者负责第三方数据披露与 consent signal。
# 多行 Compose .env 与完整 Clarity 示例见 README，变量值不得包含 Markdown 链接、反斜杠标签或 HTML 空格实体。
RENEWLET_CUSTOM_HEAD_HTML=""

# 可选：必须正好 32 个字符，用于加密 PocketBase settings 中的敏感字段。
# 源码本地开发可以留空；生产部署建议设置且不要随意轮换。
# 示例：openssl rand -hex 16
PB_ENCRYPTION_KEY=""

# 可选：配置后 PocketBase 原生密码找回邮件才会启用。
# SMTP_HOST="smtp.example.com"
# SMTP_PORT="587"
# SMTP_USER="smtp-user"
# SMTP_PASSWORD="smtp-password"
# SMTP_FROM="Renewlet <noreply@example.com>"
# SMTP_TLS="false"

# 可选：PocketBase 自动备份 cron，例如每天 03:00 保留最近 7 份。
# BACKUPS_CRON="0 3 * * *"
# BACKUPS_CRON_MAX_KEEP="7"

# 内置通知调度器默认开启，每分钟检查一次用户本地通知时间。
# 是否启用内置通知调度器；设为 "false" 时不注册通知 cron。
NOTIFICATION_SCHEDULER_ENABLED="true"
# 外部平台 Cron 调用 /api/cron/notifications 时使用；只用内置调度器可留空。
# 示例：openssl rand -base64 32
CRON_SECRET=""
# 通知调度器的 cron 表达式；默认每分钟运行一次。
NOTIFICATION_SCHEDULER_CRON="* * * * *"
# 用户本地提醒时间的命中窗口，单位分钟；默认允许计划时间后 2 分钟内发送。
NOTIFICATION_CRON_WINDOW_MINUTES="2"
# 失败通知任务的最大重试次数；设为 0 时不重试失败任务。
NOTIFICATION_MAX_RETRIES="3"
# 任务处于 sending 状态超过多少分钟视为卡住并允许重新处理；最小值为 1。
NOTIFICATION_STALE_SENDING_MINUTES="15"

# 数据目录固定为 /pb_data，由 docker-compose 的 named volume 持久化（PocketBase）。
# 首次启动后访问 http://localhost:3000/setup 创建第一个管理员用户；如果 PocketBase 还没有真实 superuser，该账号也会成为 PB Admin UI 初始账号。