Skip to main content

Static http server

Build Status Opensource ByJG GitHub source GitHub license GitHub release

A really minimal HTTP Server image for static files written in GO

Why?

  • Create a simple HTML website;
  • HTTP to serve few files
  • Really small - less than 15MB !!

Tags

  • latest - The latest image with a coming soon template
  • tiny - A really minimalist image. You need to replace the volume ot build your own on top of this one.

How to use the "Coming soon template"?

Coming soon page

The image has the coming soon template and can be customized by setting the environment variables:

  • HTML_TITLE
  • TITLE
  • MESSAGE
  • BG_IMAGE
  • FACEBOOK
  • TWITTER
  • YOUTUBE

e.g.

docker run -p 8080:8080 -e TITLE=soon -e "MESSAGE=Keep In Touch" byjg/static-httpserver

Using with Helm 3

3.2. Using HELM 3

Minimal configuration

helm repo add byjg https://opensource.byjg.com/helm
helm repo update
helm upgrade --install mysite byjg/static-httpserver \
--namespace default \
--set "ingress.hosts={www.example.org,example.org}" \
--set parameters.title=Welcome

Parameters:

ingress:
hosts: [] # Required
parameters:
htmlTitle: ""
title: "soon"
message: ""
backgroundImage: ""
facebook: ""
twitter: ""
youtube: ""
This HELM package is setup to work with [EasyHAProxy](https://github.com/byjg/docker-easy-haproxy)

Enabling as Addon on MicroK8s

The Parking addon deploys a static webserver to ‘park’ a domain. This involves all necessary ingress, service and Pods. This addon adds the proper labels which can be discovered by EasyHAProxy.

To enable this addon:

microk8s enable parking <domainlist>

… where domainlist is the comma separated list of domains to be parked.

To disable the addon:

microk8s disable parking

Follow this discussion: https://discuss.kubernetes.io/t/addon-parking/23186

Use your own static pages

docker run -p 8080:8080 -v /path/to/local/html:/static byjg/static-httpserver:tiny

Create your own image

Dockerfile

FROM byjg/static-httpserver:tiny

COPY /path/to/html /static

Open source ByJG