[groyoh]

Context

The v1.56.0 migration page covers the two changes that reject requests (the v1 page size limit and the customer text field limits). The same release has other changes that self-hosted users should check before or after upgrading.

Description

A new "Other changes to check" section was added to the v1.56.0 migration page:

• Document download links of invoices, credit notes, payment receipts and order forms now expire and use a new /documents/... path. The section covers the expiry rules, the 410 response, the old links and LAGO_LEGACY_DOCUMENT_URLS_EXPIRE_AT, and what to check in integrations that store file_url and in reverse proxies.
• Login attempt limits per IP, with LAGO_TRUSTED_PROXIES for proxies with a public address and the optional throttling Redis.
• The WebSocket origin check, which needs LAGO_FRONT_URL to match the front-end URL.
• GraphQL introspection being off unless LAGO_GRAPHQL_INTROSPECTION_ENABLED is set.
• Event timestamps out of range returning a 422, and the optional past and future limits.
• The removed GET /api/v1/organizations/grpc_token endpoint.
• The PostgreSQL and ClickHouse index migrations that can take time on large instances.
• The new Gotenberg image in the Docker Compose files.

The new optional environment variables are grouped in one table.

The page also covers the new getlago/front image, which runs nginx as a non-root user on port 8080 (8443 for TLS) instead of 80: a third change in the introduction, and a fourth step that lists what a custom Compose file, Kubernetes manifest, reverse proxy or nginx config must change (the docker-compose.yml of the Lago repository is updated in getlago/lago#836).

The environment variables reference of the self-hosted Docker page now lists the variables added in v1.56.0, with LAGO_REDIS_CABLE_URL and LAGO_REDIS_CABLE_PASSWORD, which were not documented. The LAGO_FRONT_URL row also says that it is used to check the origin of WebSocket connections.

Part of BIL-813

[michaelponrajah]

Changelog triage — possible changelog entry

This PR documents several real product/behavior changes for self-hosted users upgrading to v1.56.0: expiring document download links (new /documents/... path, 410 on old links, LAGO_LEGACY_DOCUMENT_URLS_EXPIRE_AT), per-IP login attempt limits (LAGO_TRUSTED_PROXIES), a WebSocket origin check (LAGO_FRONT_URL), GraphQL introspection off by default (LAGO_GRAPHQL_INTROSPECTION_ENABLED), event timestamp range validation (422), the removed GET /api/v1/organizations/grpc_token endpoint, and new optional Docker Compose services (Gotenberg, webhook alert worker). That reads as changed/removed behavior and changed limits, which clears our usual changelog bar.

This is an unattended triage run, so I'm not drafting an entry — just flagging it. If a human wants one written, reply here or invoke the lago-changelog-writer skill. That run would use as sources:

• This PR (docs(migration): Add the other v1.56.0 upgrade notes #775) and its base, docs(migration): Add the v1.56.0 migration page #720 ("[DO NOT MERGE] docs(migration): Add the v1.56.0 migration page")
• Linear BIL-813, referenced in the description but not linked — worth attaching the project/ticket directly
• Merged lago-api PRs for each behavior above, to verify exact defaults/handles and confirm what's shipped vs. still pending

Two things that would need resolving before a draft is ready:

• Several unrelated behaviors are bundled in one migration-guide section; the changelog's one-subject rule would likely split this into multiple entries (if any of these rise to customer-facing announcements rather than self-hosted ops notes).
• No merged engineering PRs are linked yet, so concrete handles (defaults, env var names) aren't independently verifiable from this PR alone.

---

Generated by Claude Code

[mintlify]

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

Project	Status	Preview	Updated
lago-docs	🟢 Ready	View Preview	Nov 3, 2026, 9:14 AM

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

[groyoh]

Thanks @vincent-pochet for the review!