Skip to content

Add a guide for proxying Strapi with HAProxy - #3463

Merged
pwizla merged 7 commits into
mainfrom
repo/add-haproxy-proxy-guide
Sep 11, 2026
Merged

Add a guide for proxying Strapi with HAProxy#3463
pwizla merged 7 commits into
mainfrom
repo/add-haproxy-proxy-guide

Conversation

@derrickmehaffy

@derrickmehaffy derrickmehaffy commented Sep 10, 2026

Copy link
Copy Markdown
Member

This PR adds a deployment guide for serving Strapi behind HAProxy, covering the server.url and server.proxy options, a frontend that terminates TLS, and a backend that health checks Strapi on /_health. It also documents what to account for before running several Strapi instances against one database, since schema synchronization runs once per process with no coordination between instances. It replaces the dead Strapi Forum links for HAProxy in the deployment and FAQ pages.

Stacked on #3462. Review that one first.

Direct preview link 👉 here

@vercel

vercel Bot commented Sep 10, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
documentation Ready Ready Preview Sep 11, 2026 12:44pm UTC

Request Review

@derrickmehaffy
derrickmehaffy force-pushed the repo/add-haproxy-proxy-guide branch from 8131677 to 329b256 Compare September 10, 2026 17:46
@pwizla
pwizla force-pushed the repo/add-haproxy-proxy-guide branch from 329b256 to 3c9fd28 Compare September 11, 2026 08:38
@pwizla
pwizla force-pushed the repo/add-haproxy-proxy-guide branch from 3c9fd28 to d65e2f7 Compare September 11, 2026 09:10
@pwizla
pwizla force-pushed the repo/add-haproxy-proxy-guide branch from d65e2f7 to eb28b26 Compare September 11, 2026 09:17
@pwizla
pwizla force-pushed the repo/add-haproxy-proxy-guide branch from eb28b26 to c1ed742 Compare September 11, 2026 09:33
@pwizla
pwizla force-pushed the repo/add-haproxy-proxy-guide branch from c1ed742 to 395c7ee Compare September 11, 2026 10:22
@pwizla
pwizla force-pushed the repo/add-haproxy-proxy-guide branch from 395c7ee to 86137ef Compare September 11, 2026 10:57
@pwizla
pwizla force-pushed the repo/add-haproxy-proxy-guide branch from 86137ef to 040b40c Compare September 11, 2026 11:03
@pwizla pwizla added this to the 7.2.0 milestone Sep 11, 2026
@pwizla pwizla self-assigned this Sep 11, 2026
@pwizla pwizla added internal PRs created by the Strapi core team pr: new content PRs for new product features or new documentation sections source: CMS labels Sep 11, 2026

@pwizla pwizla left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perfect, thank you! As with the other PRs, I ran another batch of Inki reviews on it and let it fix issues, + made some manual changes

@pwizla
pwizla force-pushed the repo/add-haproxy-proxy-guide branch 2 times, most recently from 5159252 to 981476a Compare September 11, 2026 12:20
@pwizla
pwizla force-pushed the repo/add-haproxy-proxy-guide branch from 981476a to c058292 Compare September 11, 2026 12:35
@pwizla
pwizla added this pull request to stack #3476 September 11, 2026 12:35
Base automatically changed from repo/add-caddy-proxy-guide to main September 11, 2026 12:42
derrickmehaffy and others added 7 commits September 11, 2026 14:43
Replaces the Strapi Forum guide that went offline when the forum shut down.
Covers the Strapi side (server.url, server.proxy, upload body limits) and the
HAProxy side, including a health check against /_health and what to account
for before running several Strapi instances against one database.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Replaces the public url, proxy header, upload limit and multi-instance blocks
with the shared snippets, keeping the sentences that describe how HAProxy
itself behaves and its timeout guidance.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@pwizla
pwizla force-pushed the repo/add-haproxy-proxy-guide branch from c058292 to 066d1aa Compare September 11, 2026 12:43
@pwizla
pwizla merged commit 7cfbdde into main Sep 11, 2026
4 of 5 checks passed
@pwizla
pwizla deleted the repo/add-haproxy-proxy-guide branch September 11, 2026 12:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

internal PRs created by the Strapi core team pr: new content PRs for new product features or new documentation sections source: CMS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants