1
0
mirror of https://github.com/dokku/buildpack-nginx.git synced 2024-11-09 05:00:50 +00:00
buildpack-nginx/README.md

18 lines
1.3 KiB
Markdown
Raw Normal View History

2014-11-18 22:30:12 +00:00
# NGINX Buildpack for Dokku - Hosting static pages
2015-01-05 20:41:24 +00:00
This buildpack has been successfully run on Digital Ocean instances of Ubuntu 14.04 (Status: Jan 2015). It might also work with different configurations.
2013-08-17 06:41:19 +00:00
2014-11-18 22:30:12 +00:00
## Purpose
2014-12-13 17:28:12 +00:00
`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.
2013-08-17 06:41:19 +00:00
2014-11-18 22:30:12 +00:00
## 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`
2015-02-15 16:54:16 +00:00
2. Add another, *empty* file called `.static` to your root directory of your web project. It signals that this buildpack shall be used
2014-11-18 22:30:12 +00:00
3. Push your project to Dokku
2014-11-18 22:30:12 +00:00
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.
## 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](http://twitter.com/TheSumOfAll/)