Docker

Prerender docker middleware

View source on Github.

This standalone docker component can be used as a middleware to prerender your website with Prerender.io when you can’t use other middlewares (or simply when you prefer to do it this way).

How-To

1. Assign a secondary domain to your website.

E.g. if your website is www.example.com (primary domain), then point www2.example.com (secondary domain) to your website too.

2. Edit the Dockerfile to match your settings.

Set your secondary domain, primary domain and API key. You may want to use environment variables later, but we suggest you do it in the file first to avoid environment compatibility issues during your first setup.

3. Optional

At this point, you can test your setup locally by running the docker container on your computer. For this, you need to have a configured Docker Engine or Docker desktop running on your computer.

make run
curl http://localhost:8080

4. Setup this docker container to run as a standalone server.

This step highly depends on your infrastructure so it's hard to give you more suggestions here. Still, a common step is to upload this dockerfile to a component-based cloud provider, such as Digital Ocean App Platform, Heroku, AWS ECS or Elastic Beanstalk. Or use your already existing, Docker-capable kubernetes cluster, as you like.

5. Point your primary domain to this new component.

At this point you're good to use a CNAME too, as this is a brand new component.

6. Test

Send a few request to your primary domain using curl, and see how it responds to different user agents.

Emulate a normal user request

The user agent could be anything that doesn't look like a bot, we just added something here for clarity.

curl -A Chrome https://www.example.com

Emulate a bot request

curl -A Googlebot https://www.example.com