https://github.com/rhzs/nginx-static

Lightweight Nginx Static suitable for ReactJS, VueJS, Svelte, Other SPAs
https://github.com/rhzs/nginx-static

docker http-server lightweight nginx serves static-site traefik

Last synced: 16 days ago
JSON representation

Lightweight Nginx Static suitable for ReactJS, VueJS, Svelte, Other SPAs

• Host: GitHub
• URL: https://github.com/rhzs/nginx-static
• Owner: rhzs
• Created: 2020-03-19T08:42:16.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2020-03-19T08:42:49.000Z (almost 5 years ago)
• Last Synced: 2024-11-07T04:41:06.315Z (2 months ago)
• Topics: docker, http-server, lightweight, nginx, serves, static-site, traefik
• Language: Dockerfile
• Size: 2.93 KB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
[![](https://images.microbadger.com/badges/image/rhzs/nginx-static.svg)](https://microbadger.com/images/rhzs/nginx-static "Get your own image badge on microbadger.com") ![](https://img.shields.io/docker/pulls/rhzs/nginx-static.svg)

# Lightweight Nginx Image

`docker run -v /absolute/path/to/serve:/static -p 8080:80 rhzs/nginx-static`

This command exposes an nginx server on port 8080 which serves the folder `/path/to/serve` from the host.

The image can only be used for static file serving but has with **less than 4 MB** roughly 1/10 the size of the official nginx image. The running container needs **~1 MB RAM**.

### nginx-static via HTTPS

To serve your static files over HTTPS you must use another reverse proxy. We recommend [træfik](https://traefik.io/) as a lightweight reverse proxy with docker integration. Do not even try to get HTTPS working with this image only, as it does not contain the nginx ssl module.

### nginx-static with docker-compose

This is an example entry for a `docker-compose.yaml`

```

version: '3'

services:

  example.org:

    image: rhzs/nginx-static

    container_name: example.org

    ports:

      - 8080:80

    volumes: 

      - /path/to/serve:/static

```

### nginx-static with træfik 2.1

To use nginx-static with træfik 2.1 add an entry to your services in a docker-compose.yaml. To set up traefik look at this [simple example](https://docs.traefik.io/user-guides/docker-compose/basic-example/). 

In the following example, replace everything contained in  and the domain with your values.

```

services:

  traefik:

    image: traefik:2.1

  # Your treafik config.

    ...

  example.org:

    image: rhzs/nginx-static

    container_name: example.org

    expose:

      - 80

    labels:

      - "traefik.enable=true"

      - "traefik.http.routers..rule=Host(`example.org`)"

      - "traefik.http.routers..entrypoints="

# If you want to enable SSL, uncomment the following line.

#      - "traefik.http.routers..tls.certresolver="

    volumes: 

      - /host/path/to/serve:/static

```

If traefik and the nginx-static are in distinct docker-compose.yml files, please make sure that they are in the same network.

For a traefik 1.7 example look [at an old version of the readme](https://github.com/rhzs/docker-nginx-static/blob/bb46250b032d187cab6029a84335099cc9b4cb0e/README.md)

### nginx-static for multi-stage builds

nginx-static is also suitable for multi-stage builds. This is an example Dockerfile for a static nodejs application:

```

FROM node:alpine

WORKDIR /usr/src/app

COPY . /usr/src/app

RUN npm install && npm run build

FROM rhzs/nginx-static

RUN apk update && apk upgrade

COPY --from=0 /usr/src/app/dist /static

```