Skip to content

docs: warn about escaping $ in SMTP_PASSWORD#2406

Closed
Teraformerrr wants to merge 1 commit intobaptisteArno:mainfrom
Teraformerrr:docs/smtp-password-dollar-sign-escape
Closed

docs: warn about escaping $ in SMTP_PASSWORD#2406
Teraformerrr wants to merge 1 commit intobaptisteArno:mainfrom
Teraformerrr:docs/smtp-password-dollar-sign-escape

Conversation

@Teraformerrr
Copy link
Copy Markdown

What does this PR do?

Adds documentation warning about the $ character in SMTP_PASSWORD values.

Problem

When SMTP_PASSWORD contains a $ character, the dotenv CLI (used to start the app) passes values through shell interpolation. The $ is treated as the start of a variable name, silently corrupting the password and causing 535 Incorrect authentication data errors.

For example, abc$defghij silently becomes abc at runtime.

Changes

  • .env.example: Added SMTP configuration block with warning about $ escaping
  • .env.dev.example: Same SMTP block and warning added
  • apps/docs/self-hosting/configuration.mdx: Added a <Note> with correct/incorrect examples after the SMTP table

Related Issue

Fixes the issue reported by @alehostert regarding SMTP_PASSWORD dollar sign escaping.

The dotenv CLI interprets $ as shell variable interpolation,
which silently corrupts SMTP passwords containing $.
Added warnings to .env.example, .env.dev.example, and configuration docs.
@vercel
Copy link
Copy Markdown

vercel bot commented Feb 25, 2026

@Teraformerrr is attempting to deploy a commit to the Typebot Team on Vercel.

A member of the Team first needs to authorize it.

@baptisteArno
Copy link
Copy Markdown
Owner

I appreciate the PR but I think it is out of scope to be honest, Typebot should not document how dotenv cli .env parsing works.

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