dokku-nginx-alt is a alternative plugin for dokku that configures nginx as a reverse proxy to deployed dokku app. There are a number of design changes between this plugin and the standard built in dokku-vhosts plugin:
- Moved configuration file from
post-deployinto separate template files:nginx.confandnginx.ssl.conf. - Ability to override default .conf files with user's own nginx configuration
files placed in
/home/git/$APP. - Ability to deploy an app under multiple custom domains. The
VHOSTfile can now contain a list of domains that nginx will serve to. VHOSTfile is decoupled frompost-deployin thatpost-deployno longer overwritesVHOSTafter each deploy. Custom domains are set independently in theVHOSTfile.- Ability to mix SSL and non-SSL domains. For example,
VHOSTmay containmydomain.comand*.mydomain.comwhere SSL certificates only apply to*.mydomain.com. This plugin generates both SSL configurations for the wildcard domains and non-SSL configuration for the root domain. - Added helper messages during deploy.
This plugin has been tested on dokku version 0.2.3.
-
Remove the default
nginx-vhostplugin:rm -rf /var/lib/dokku/plugins/nginx-vhost
-
Install the plugin by cloning into the dokku plugins directory:
git clone https://github.com/mikexstudios/dokku-nginx-alt.git /var/lib/dokku/plugins/nginx-alt
-
Create a
VHOSTfile in your dokku app directory (e.g./home/dokku/[app name]/VHOST) and add each domain name on a separate line. -
To over-ride the default
nginx.confandnginx.ssl.conftemplates, place copies renamed asnginx.templateandnginx.ssl.templatein your/home/dokku/$APPdirectory. When you re-push your application, you should see a message like:-----> Overriding default SSL nginx.conf with detected nginx.template... -
Re-push your app.
backup-exportandbackup-importhook scripts have intentionally not been included to reduce the complexity of this plugin.
The MIT License (MIT)