Most of a club’s setup is done in the app, under Configure. A few
settings come from the server’s environment (.env), because they’re
about the server rather than the club. The full list, with notes, is in
server/.env.example.
| Variable |
What it’s for |
DATABASE_URL |
The club’s Postgres database. |
SESSION_SECRET |
Signs sign-in sessions. A long random value; never share it. |
| Variable |
Default |
What it’s for |
CLUB_NAME |
My Club |
The app’s title until an admin changes it. |
CLUB_ID |
club |
A short id, used in sign-in sessions and unsubscribe links. |
CLUB_FEATURES |
a lodge club’s |
Comma-separated: roomBookings, stageOne, lodgeManager, events, handicaps, forum, reports. |
BILLING_MODE |
live |
test keeps every invoice and payment out of real totals while you set up. |
DEMO_CLUB |
|
true makes the club a public demo: no sign-in, reset every 30 minutes. |
PUBLIC_BASE_URL |
|
Where links in emails point, e.g. https://club.example.org. |
A lodge club’s default is every feature except events, handicaps and
lodgeManager. A golf club might use events,handicaps,forum.
| Variable |
What it’s for |
COOKIE_SECURE |
true once the site is served over HTTPS. |
SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS, MAIL_FROM |
A server-wide email account, for a club that hasn’t set its own (Configure > Connections > Email server). |
OPEN_METEO_API_KEY |
A weather-data licence for every club on the server; see Weather data. |
KALLH_PLUGINS |
Plugins to load; see Plugins. |
PG_POOL_MAX, PG_POOL_IDLE_MS |
Database connections (default 3, closed after 30 seconds idle). |