Skip to content

Add LD_SETUP_PROJECTS multi-project initialization documentation#551

Merged
rephus merged 1 commit intomainfrom
04-20-add_ld_setup_projects_multi-project_initialization_documentation
Apr 20, 2026
Merged

Add LD_SETUP_PROJECTS multi-project initialization documentation#551
rephus merged 1 commit intomainfrom
04-20-add_ld_setup_projects_multi-project_initialization_documentation

Conversation

@rephus
Copy link
Copy Markdown
Contributor

@rephus rephus commented Apr 20, 2026

Documents the new LD_SETUP_PROJECTS environment variable, which allows provisioning multiple Lightdash projects at boot via a JSON array. This is an Enterprise-only feature that replaces the single-project LD_SETUP_PROJECT_* and LD_SETUP_GITHUB_* variables when set.

The new section covers:

  • How project matching works on boot (by name, creating or updating in place)
  • Required companion variables (LD_SETUP_ADMIN_EMAIL and organization/API key vars)
  • Full JSON schema for each project entry, including Databricks warehouse fields and GitHub dbt connection fields
  • A two-project example with shell quoting guidance
  • Validation errors and their causes
  • A migration guide for moving from the legacy single-project variables to the new array format

@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented Apr 20, 2026

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

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

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

Copy link
Copy Markdown
Contributor Author

rephus commented Apr 20, 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 Apr 20, 2026

🤖 Documentation Bot

All checks passed! No issues found.

@rephus rephus force-pushed the 04-20-add_ld_setup_projects_multi-project_initialization_documentation branch from 29e51e5 to 4721bfd Compare April 20, 2026 11:10
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 20, 2026

🤖 Documentation Bot

All checks passed! No issues found.

@rephus rephus marked this pull request as ready for review April 20, 2026 11:11
@rephus rephus merged commit 1a036d7 into main Apr 20, 2026
6 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