.env.example

# Gophenberg configuration. Copy to .env and fill in the values.
# Real environment variables take precedence over anything set here.

GOPHENBERG_DATABASE_URL=postgres://postgres:gophenberg@localhost:5435/postgres?sslmode=disable
# GOPHENBERG_ADDR=localhost:8081

# Name the public site carries in its chrome. Defaults to Gophenberg.
# GOPHENBERG_SITE_TITLE=Gophenberg

# GOPHENBERG_FEED_TITLE=Gophenberg
# GOPHENBERG_FEED_ITEMS=20

# Comma-separated CIDR ranges of reverse proxies allowed to set X-Forwarded-* headers.
# Behind a TLS-terminating proxy this must list it, or public links are built as http.
# GOPHENBERG_TRUSTED_PROXIES=10.0.0.0/8

# The address people reach the site at. When set, a write sent to any other address is refused.
# GOPHENBERG_PUBLIC_URL=https://example.com

# Where themes are installed, one directory per theme. Admin uploads write here, so any mount
# has to stay writable. The image sets /themes and expects a volume there.
# GOPHENBERG_THEMES_DIR=/srv/gophenberg/themes

# Pins one theme, overriding the admin. Empty lets the admin choose which theme serves.
# GOPHENBERG_THEME=starter

# Where uploaded media is stored, under year and month directories. Uploads write here and the
# public site serves the files from it, so any mount has to stay writable and has to survive a
# restart. Unset, the media library refuses every upload. The image sets /media and expects a
# volume there.
# GOPHENBERG_MEDIA_DIR=/srv/gophenberg/media

# The node binary a theme is served with. Defaults to node on PATH, and the image sets it to the
# node it ships at /nodejs/bin/node.
# GOPHENBERG_NODE_BIN=node

# The largest upload the media library takes, in megabytes.
# GOPHENBERG_MEDIA_UPLOAD_CAP_MB=128

# How long a media or theme upload has to arrive, in place of the HTTP read timeout.
# GOPHENBERG_UPLOAD_TIMEOUT=5m

# The largest definitions file an import takes, in kilobytes, up to 1024.
# GOPHENBERG_DEFINITIONS_IMPORT_CAP_KB=256

# How many containers a field may stand inside, from 1 to 1000. A flexible content layout counts
# as one.
# GOPHENBERG_FIELD_DEPTH=32

# How long a starting theme has to answer before it is given up on, and how many times it is tried
# again. Raise the timeout for a theme that boots slowly on modest hardware.
# GOPHENBERG_THEME_READY_TIMEOUT=30s
# GOPHENBERG_THEME_START_ATTEMPTS=5

# How long to wait before retrying a theme that will not start, doubling after each attempt up to
# the maximum.
# GOPHENBERG_THEME_BACKOFF=500ms
# GOPHENBERG_THEME_MAX_BACKOFF=30s

# How long a theme has to stop before it is killed, and how long a running theme has to start
# answering one request.
# GOPHENBERG_THEME_STOP_GRACE=3s
# GOPHENBERG_THEME_PROXY_TIMEOUT=10s

# How long a browser may keep a site asset or an uploaded file. Behind a proxy that sets its own
# Cache-Control the proxy wins for assets.
# GOPHENBERG_CACHE_ASSET_MAX_AGE=1h
# GOPHENBERG_CACHE_MEDIA_MAX_AGE=1h

# How long a shared cache may serve a public content answer, and how much longer it may serve the
# old one while fetching a fresh one. Write whole seconds, like 1h or 90s.
# GOPHENBERG_CACHE_CONTENT_SHARED_MAX_AGE=1m
# GOPHENBERG_CACHE_CONTENT_STALE_WHILE_REVALIDATE=5m

# How long a visitor has to send a request's headers and the whole request, and how long an idle
# connection waits for its next request.
# GOPHENBERG_HTTP_READ_HEADER_TIMEOUT=10s
# GOPHENBERG_HTTP_READ_TIMEOUT=30s
# GOPHENBERG_HTTP_IDLE_TIMEOUT=2m

# How long a stop gives running requests to finish, how long the ones cancelled after that get to
# end, and how long the plugins get to stop. Whatever stops the server must wait longer than these
# three and the theme stop grace added together.
# GOPHENBERG_SHUTDOWN_GRACE=10s
# GOPHENBERG_SHUTDOWN_CANCEL_GRACE=5s
# GOPHENBERG_SHUTDOWN_STOP_GRACE=5s

# Credentials for the translation platform, read by make translations and make translations-retire.
# The scheduled workflow takes these from repository secrets instead.
# POEDITOR_API_TOKEN=
# POEDITOR_PROJECT_ID=