Hackey way I make self contained GoLang packages with embedded html (uses makefile)
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Hackey Golang Builder

Try running it in Docker

docker run -it -p 3000:3000 -e github='https://github.com/pmcdowell-okta/hackey-golang-build.git' oktaadmin/gitpull

For Golang Projects where you want to bake your HTML into your binary

This project is mostly for my own benefit, but others might find it useful.

I prefer to ship Golang projects with everything self contained in a single binary, mostly it is a bunch of:

  • HTML
  • Images
  • Javascript
  • Templates, you name it.

This is how I build my binaries for this.

How do I use it:

If can use my Makefile, you are in luck. Just run: make setup ; Pulls down the necessary dependencies make build ; Compiles the HTML into GOLANG code, and include my handler  /bin/main ; run the binary

Then, if you connect to port 3000 http://localhost:3000, you "should see a webpage"

If you want to build it manually, love the enthusiasm, make sure you export the local GOPATH so everything will be found.

export GOPATH=`pwd`

  1. Put everything you want to include in your package in the html directory
  2. use make build to build you executable

Make uses go-bindata-assetfs to basically zips everything up, and creates a package in the src/localhtml directory.

Then it uses:

  • go build ./... Builds the packages
  • go install ./... Builds the binaries

When you are done you should have a binary called main in the bin directory


There is a test in the src/localtest directory to make sure you can read the local filesystem, but it is very basic

You can go the the src/localhtml directory and run go test, or you can run the test globally using make test

Try it on Docker

If you want to try this code on Docker, you can run:

  • make buildlinux
  • make runlinux

Everything is documented in the Makefile

This will spin up the example on a Ubuntu image in Docker, and open port 3000 so you can try it out

There is also an option to build for Windows

  • make buildwindows