Skip to content

docs: add environment variables reference guide#3539

Closed
Smolcup wants to merge 1 commit intobluewave-labs:developfrom
Smolcup:docs/add-environment-variables-guide
Closed

docs: add environment variables reference guide#3539
Smolcup wants to merge 1 commit intobluewave-labs:developfrom
Smolcup:docs/add-environment-variables-guide

Conversation

@Smolcup
Copy link
Copy Markdown
Contributor

@Smolcup Smolcup commented Apr 17, 2026

Describe your changes

Adds comprehensive documentation for all environment variables used by Checkmate server and client.

Write your issue number after "Fixes "

No issue was fixed, this is a documentation contribution.

Please ensure all items are checked off before requesting a review. "Checked off" means you need to add an "x" character between brackets so they turn into checkmarks.

  • (Do not skip this or your PR will be closed) I deployed the application locally.
  • (Do not skip this or your PR will be closed) I have performed a self-reviewing and testing of my code.
  • I have included the issue # in the PR.
  • I have added i18n support to visible strings (instead of <div>Add</div>, use):
const { t } = useTranslation();
<div>{t('add')}</div>
  • I have not included any files that are not related to my pull request, including package-lock and package-json if dependencies have not changed
  • I didn't use any hardcoded values (otherwise it will not scale, and will make it difficult to maintain consistency across the application).
  • I made sure font sizes, color choices etc are all referenced from the theme. I don't have any hardcoded dimensions.
  • My PR is granular and targeted to one specific feature.
  • There are two database implementations (MongoDB and PostgreSQL TimescaleDB) and I have taken care of them appropriately.
  • I ran npm run format in server and client directories, which automatically formats your code.
  • I took a screenshot or a video and attached to this PR if there is a UI change.

Copy link
Copy Markdown
Collaborator

@ajhollid ajhollid left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These docs are inaccurate, please review the source code

Comment thread docs/environment-variables.md Outdated
Comment on lines +12 to +13
| `REDIS_HOST` | Redis host | `localhost` |
| `REDIS_PORT` | Redis port | `6379` |
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no longer used

Comment thread docs/environment-variables.md Outdated
| `REDIS_HOST` | Redis host | `localhost` |
| `REDIS_PORT` | Redis port | `6379` |
| `TOKEN_TTL` | JWT token expiry | `99d` |
| `REFRESH_TOKEN_TTL` | Refresh token expiry | `7d` |
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

RERFRESH_TOKEN_TTL no longer used

Comment thread docs/environment-variables.md Outdated
Comment on lines +25 to +31
| Variable | Description |
|----------|-------------|
| `SYSTEM_EMAIL_ADDRESS` | From address for emails |
| `SMTP_HOST` | SMTP server host |
| `SMTP_PORT` | SMTP server port |
| `SMTP_USER` | SMTP username |
| `SMTP_PASSWORD` | SMTP password |
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not used

Comment thread docs/environment-variables.md Outdated
Comment on lines +33 to +38
## Optional Features

| Variable | Description |
|----------|-------------|
| `PAGESPEED_API_KEY` | Google PageSpeed API key |
| `DOCKER_HOST` | Docker daemon socket path |
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not used

@Smolcup
Copy link
Copy Markdown
Contributor Author

Smolcup commented Apr 19, 2026

Thank you for your feedback, I'll get back to working on it!

@Smolcup Smolcup force-pushed the docs/add-environment-variables-guide branch from d555f1f to 6b43a41 Compare April 19, 2026 19:38
@Smolcup
Copy link
Copy Markdown
Contributor Author

Smolcup commented Apr 19, 2026

I have updated the file accordingly, thank you for your work!

Copy link
Copy Markdown
Collaborator

@ajhollid ajhollid left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are some missing vars and some other minor changes to make, please see my comments in the code review.

Thanks!


| Variable | Description | Default |
|----------|-------------|---------|
| `NODE_ENV` | Application environment | `development` |
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

missing PORT var

| `NODE_ENV` | Application environment | `development` |
| `LOG_LEVEL` | Logging level | `debug` |
| `TOKEN_TTL` | JWT token expiry time | `99d` |
| `CLIENT_HOST` | Frontend URL | `http://localhost:5173` |
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CLIENT_HOST is required


## Notes

- The server reads these variables from `server/.env`
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All vars are read from server/.env, this line seems to indicate that only JWT_SECRET and TOKEN_TTL are read from .env. This line can just be removed safely.

# Environment Variables

This document describes the environment variables used by Checkmate server.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing the required client env vars

VITE_APP_API_BASE_URL
VITE_APP_CLIENT_HOST

@ajhollid
Copy link
Copy Markdown
Collaborator

Closing as inactive

@ajhollid ajhollid closed this Apr 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants