HAProxy Integration Guide
This guide shows how to configure HAProxy with Prerender.io to serve prerendered pages to search engine bots. This improves SEO by delivering fully rendered HTML to bots, making it ideal for client-side rendered sites that want better indexing without backend changes.
Please note that this integration is community-maintained, not officially supported by Prerender. We only provide a guide for integrating Prerender with their service.
View the HAProxy config here: https://gist.github.com/roylines/7dc14c419523975daaa7
Important Notes
-
Replace
YOUR_TOKEN
with your actual Prerender API token. -
Replace
http://example.com
with your website’s base URL. -
The
timeout server
value (20s) can be adjusted depending on your expected render time. -
This configuration excludes static assets from being routed to Prerender for efficiency.
-
If you are using HTTPS for your website, additional SSL configuration in HAProxy may be needed.
-
Testing in a staging environment before deploying to production is recommended.
Verify Your Installation
After integration, it’s important to verify that everything is working as expected. We’ve provided an easy-to-follow guide to help you test your setup and confirm that Prerender is functioning properly.
Or, test with curl
command with a custom User-Agent
header:
curl -v -A googlebot www.yourpage.com/
Is the Prerender integration working on other pages?
Test if the Prerender integration works on the other pages based on this guide: Verify the integration
If you don't see the Prerender headers / IDs, then the Integration is not working, which might be why the other URL is not cached.
Getting an Error?
If you see the message "Prerender Integration Not Detected," you can refer to the troubleshooting guide here to help resolve the issue.
Expert Assistance
For those who need additional help or want to ensure a smooth and secure launch, we offer a specialized package:
Kickstart Package
Price: $800 (one-time payment)
This one-time package empowers you with expert setup and configuration, ensuring a smooth and secure launch.
Features:
- Three setup and configuration sessions with our experts
- Onboarding assistance
- Security assessment
To learn more about this package or to purchase, visit the Packages section under the Billing menu in your Prerender dashboard.
Get Support
If you're still encountering issues after implementing Prerender:
- Review your implementation against our documentation
- Contact our support team:
- Email: support@prerender.io
- Support Ticket: Submit a ticket
- Chat: Available from your Prerender dashboard
To help us resolve your issue as quickly as possible, please gather and include any relevant information, such as:
- Error messages you're seeing
- Steps you've already taken to troubleshoot
- Screenshots or screen recordings (if applicable)
Providing these details up front will help our team diagnose the problem more efficiently and get you back on track faster.
Related Articles / FAQs:
- Available integrations
- How to add additional bots (integrations maintained by Prerender)
- How to add multiple domains?
- How Can I Integrate Prerender With My React/Angular/Vue Application?
- How Can I Integrate Prerender If I'm Using a Hosting Platform That Doesn't Allow Direct Server Access?
- How to check cached versions of your URLs?
- Why Am I Seeing 403 or 404 Errors After Integrating Prerender?