NGINX Docker image for SPAs

This docker image can be used for single page apps (SPAs) in history mode.

What it does

Single page applications (SPAs) often use the HTML5 history API. This results in neat urls like /user/john, but will result in a 404 when accessed directly in the browser.

This means you have to configure your webserver to serve your entrypoint (index.html) on all routes per default, which es exactly what this docker image does.

Additionally, routes containing a dot will default to a 404 to prevent sending the index.html for routes like /static/asset.js. This is super useful in my opinion, but may break your app if you have app urls with dots in it (which I doubt).

App Setup

To create your own dockerfile, simply copy your distribution folder (often dist/ or build/) to /app inside the image.

FROM steebchen/nginx-spa:stable

COPY dist/ /app

EXPOSE 80

CMD ["nginx"]

Simply run your container as follows:

docker build -t your-app .
docker run -p 8000:80 your-app

Now you can visit http://localhost:8000/ in your browser or run curl -v http://localhost:8000/ to check if it's working.

Supported tags and dockerfile links

• latest (dockerfile)
• stable (dockerfile)

Notes

The daemon is already turned of in the settings.