Skip to content

docs: add persistent download URL environment variables #403

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
charliedowler merged 5 commits into from
Feb 13, 2026
Merged

docs: add persistent download URL environment variables #403

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
fc65812
docs: add persistent download URL environment variables
charliedowler Feb 12, 2026
a2e838c
docs: remove redundant S3 signed URL mention
charliedowler Feb 12, 2026
951c56d
docs: restore S3 signed URL mention for clarity
charliedowler Feb 12, 2026
8038f7c
docs: restructure persistent download URLs into standalone section
charliedowler Feb 13, 2026
71ed808
docs: clarify S3_EXPIRATION_TIME is ignored with persistent URLs
charliedowler Feb 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions self-host/customize-deployment/environment-variables.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -138,6 +138,15 @@ These variables allow you to configure [S3 Object Storage](/self-host/customize-
| `RESULTS_S3_ACCESS_KEY` | Access key for authenticating with the S3 query storage bucket (default=S3_ACCESS_KEY) |
| `RESULTS_S3_SECRET_KEY` | Secret key for authenticating with the S3 query storage bucket (default=S3_SECRET_KEY) |

## Persistent download URLs

When enabled, CSV and dashboard ZIP exports return a stable Lightdash-hosted URL (e.g. `https://lightdash.example.com/api/v1/file/{id}`) instead of a direct S3 signed URL. Each time this URL is accessed, Lightdash generates a short-lived S3 signed URL and redirects to it — so the underlying URL never goes stale and download links survive IAM credential rotation.

| Variable | Description |
| :------------------------------------------- | :----------------------------------------------------------------------- |
| `PERSISTENT_DOWNLOAD_URLS_ENABLED` | Enables persistent download URLs (default=false) |
| `PERSISTENT_DOWNLOAD_URL_EXPIRATION_SECONDS` | How long the persistent URL remains accessible (default=259200, 3 days). When persistent URLs are enabled, `S3_EXPIRATION_TIME` is ignored and each redirect generates a signed URL that expires after 5 minutes. |

## Cache

<Info>
Expand Down