Skip to content

Add INTERNAL_LIGHTDASH_HOST_IGNORE_HTTPS_ERRORS docs for internal HTTPS headless browser setup#592

Merged
rephus merged 1 commit intomainfrom
05-04-add_internal_lightdash_host_ignore_https_errors_docs_for_internal_https_headless_browser_setup
May 4, 2026
Merged

Add INTERNAL_LIGHTDASH_HOST_IGNORE_HTTPS_ERRORS docs for internal HTTPS headless browser setup#592
rephus merged 1 commit intomainfrom
05-04-add_internal_lightdash_host_ignore_https_errors_docs_for_internal_https_headless_browser_setup

Conversation

@rephus
Copy link
Copy Markdown
Contributor

@rephus rephus commented May 4, 2026

Documents the new INTERNAL_LIGHTDASH_HOST_IGNORE_HTTPS_ERRORS environment variable and adds a dedicated section explaining how to run Lightdash on a fully internal HTTPS network when SECURE_COOKIES=true.

The new section covers why plain HTTP for INTERNAL_LIGHTDASH_HOST fails in this configuration (HSTS causing Chrome to auto-upgrade requests), and provides two options for handling TLS on the internal hostname:

  • Option A – terminate TLS with a publicly-trusted certificate (recommended), requiring no additional configuration beyond setting INTERNAL_LIGHTDASH_HOST to an HTTPS URL.
  • Option B – terminate TLS with a self-signed certificate and set INTERNAL_LIGHTDASH_HOST_IGNORE_HTTPS_ERRORS=true to skip TLS validation for screenshot traffic, with a note on the security trade-off and when this is appropriate.

The environment variables reference is updated to include INTERNAL_LIGHTDASH_HOST_IGNORE_HTTPS_ERRORS with a description of its behaviour, default value, and a link to the new section.

@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 4, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview May 4, 2026, 11:09 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Copy link
Copy Markdown
Contributor Author

rephus commented May 4, 2026

This stack of pull requests is managed by Graphite. Learn more about stacking.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 4, 2026

🤖 Documentation Bot

All checks passed! No issues found.

@rephus rephus force-pushed the 05-04-add_internal_lightdash_host_ignore_https_errors_docs_for_internal_https_headless_browser_setup branch from 6d0b089 to d1f089d Compare May 4, 2026 11:11
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 4, 2026

🤖 Documentation Bot

All checks passed! No issues found.

@rephus rephus marked this pull request as ready for review May 4, 2026 11:12
@rephus rephus merged commit 4a5ba74 into main May 4, 2026
5 checks passed
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.

1 participant