1
0
mirror of https://github.com/dokku/buildpack-nginx.git synced 2024-11-22 09:23:05 +00:00
Go to file
Florian Heinemann 805e24be7f Merge pull request #9 from portokallidis/patch-1
Add documentation for nginx custom configuration
2015-10-30 13:15:32 +01:00
bin Merge pull request #7 from Crispy1975/hotfix/path-test 2015-09-11 11:50:51 +08:00
conf added ROOT param 2015-10-05 17:09:58 -07:00
LICENSE Relicense to CC0 2013-11-11 16:09:17 -08:00
README.md Add documentation for nginx custom configuration 2015-10-30 13:56:00 +02:00

NGINX Buildpack for Dokku - Hosting static pages

This buildpack has been successfully run on Digital Ocean instances of Ubuntu 14.04 (Status: Jan 2015). It might also work with different configurations.

Purpose

buildpack-nginx provides a simple, low overhead way of hosting static pages and websites on Dokku. Just add the .env and .static file to the root directory of your website as described below.

Usage

  1. Add a file with the name .env in the root of your directory with the following content: export BUILDPACK_URL=https://github.com/florianheinemann/buildpack-nginx.git
  2. Add another, empty file called .static to your root directory of your web project. It signals that this buildpack shall be used
  3. Push your project to Dokku

All static files that you want to serve should be in the root directory of your repository. No need to use a seperate www folder. buildpack-nginx will automatically download the buildpack, download NGINX, compile it, and install it. The next time you push your project, the buildpack will reuse the precompiled binaries.

NGINX CONFIGURATION

Override default configuration by adding nginx.conf.erb in the root directory

Credits and License

buildpack-nginx is licensed under the CC0 1.0 Universal license and has been informed by many similar projects on the web

Florian Heinemann