2014-10-04 04:24:22 -04:00
# Plugins
Dokku itself is built out of plugins and uses [pluginhook ](https://github.com/progrium/pluginhook ) for its plugin system. In essence a plugin is a collection of scripts that will be run based on naming convention.
Let's take a quick look at the current dokku nginx plugin that's shipped with dokku by default.
nginx-vhosts/
├── commands # contains additional commands
├── install # runs on dokku installation
└── post-deploy # runs after an app is deployed
## Installing a plugin
2014-12-19 15:09:38 -05:00
```shell
2014-10-04 04:24:22 -04:00
cd /var/lib/dokku/plugins
git clone <git url>
dokku plugins-install
```
> todo: add a command to dokku to install a plugin, given a git repository `dokku plugin:install <git url>`?
## Creating your own plugin
2015-02-18 01:49:42 -05:00
[See the full documentation ](http://progrium.viewdocs.io/dokku/development/plugin-creation ).
2014-11-23 18:09:11 -05:00
2014-10-04 04:24:22 -04:00
## Community plugins
Note: The following plugins have been supplied by our community and may not have been tested by dokku maintainers.
2014-11-22 15:37:29 -05:00
[agco-adm]: https://github.com/agco-adm
[ademuk]: https://github.com/ademuk
[alex-sherwin]: https://github.com/alex-sherwin
[alexanderbeletsky]: https://github.com/alexanderbeletsky
2014-10-04 04:24:22 -04:00
[Aomitayo]: https://github.com/Aomitayo
[apmorton]: https://github.com/apmorton
2014-11-22 15:37:29 -05:00
[blag]: https://github.com/blag
[cameron-martin]: https://github.com/cameron-martin
2014-10-04 04:24:22 -04:00
[cedricziel]: https://github.com/cedricziel
[cef]: https://github.com/cef
2015-04-28 15:53:32 +02:00
[cjblomqvist]: https://github.com/cjblomqvist
2014-11-22 15:37:29 -05:00
[darkpixel]: https://github.com/darkpixel
[dyson]: https://github.com/dyson
2014-10-04 04:24:22 -04:00
[F4-Group]: https://github.com/F4-Group
[fermuch]: https://github.com/fermuch
2014-11-22 15:37:29 -05:00
[fgrehm]: https://github.com/fgrehm
[gdi2290]: https://github.com/gdi2290
2014-10-04 04:24:22 -04:00
[heichblatt]: https://github.com/heichblatt
2014-11-22 15:37:29 -05:00
[hughfletcher]: https://github.com/hughfletcher
2014-10-04 04:24:22 -04:00
[iskandar]: https://github.com/iskandar
2014-11-22 15:37:29 -05:00
[jeffutter]: https://github.com/jeffutter
[jezdez]: https://github.com/jezdez
[jlachowski]: https://github.com/jlachowski
[krisrang]: https://github.com/krisrang
[Kloadut]: https://github.com/Kloadut
[luxifer]: https://github.com/luxifer
[mlebkowski]: https://github.com/mlebkowski
2014-10-04 04:24:22 -04:00
[matto1990]: https://github.com/matto1990
2014-11-22 15:37:29 -05:00
[michaelshobbs]: https://github.com/michaelshobbs
[mikecsh]: https://github.com/mikecsh
[mikexstudios]: https://github.com/mikexstudios
[motin]: https://github.com/motin
[musicglue]: https://github.com/musicglue
[neam]: https://github.com/neam
2015-03-10 15:27:54 +01:00
[nickstenning]: https://github.com/nickstenning
2014-11-22 15:37:29 -05:00
[nornagon]: https://github.com/nornagon
2014-10-04 04:24:22 -04:00
[ohardy]: https://github.com/ohardy
2014-11-22 15:37:29 -05:00
[pauldub]: https://github.com/pauldub
[pnegahdar]: https://github.com/pnegahdar
[RaceHub]: https://github.com/racehub
[rlaneve]: https://github.com/rlaneve
[robv]: https://github.com/robv
[scottatron]: https://github.com/scottatron
[sehrope]: https://github.com/sehrope
[statianzo]: https://github.com/statianzo
[stuartpb]: https://github.com/stuartpb
[thrashr888]: https://github.com/thrashr888
[wmluke]: https://github.com/wmluke
[Zenedith]: https://github.com/Zenedith
2015-02-22 18:50:46 +10:30
[sekjun9878]: https://github.com/sekjun9878
2015-03-06 18:53:35 +01:00
[Flink]: https://github.com/Flink
2015-03-23 13:29:08 +02:00
[ribot]: https://github.com/ribot
2015-04-12 03:24:03 +10:00
[Benjamin-Dobell]: https://github.com/Benjamin-Dobell
2014-10-04 04:24:22 -04:00
### Datastores
2014-11-17 17:03:22 -05:00
#### Relational
2014-11-22 15:37:29 -05:00
| Plugin | Author | Compatibility |
| ------------------------------------------------------------------------------------------------- | --------------------- | --------------------- |
| [MariaDB ](https://github.com/Kloadut/dokku-md-plugin ) | [Kloadut][] | Compatible with 0.2.0 |
| [MariaDB (single container) ](https://github.com/ohardy/dokku-mariadb ) | [ohardy][] | Compatible with 0.2.0 |
| [MySQL ](https://github.com/hughfletcher/dokku-mysql-plugin ) | [hughfletcher][] | |
| [PostgreSQL ](https://github.com/Kloadut/dokku-pg-plugin ) | [Kloadut][] | Compatible with 0.2.0 |
| [PostgreSQL ](https://github.com/jezdez/dokku-postgres-plugin ) | [jezdez][] | Compatible with 0.2.0 |
| [PostgreSQL ](https://github.com/jlachowski/dokku-pg-plugin ) | [jlachowski][] | IP & PORT available directly in linked app container env variables (requires link plugin)|
| [PostgreSQL (single container) ](https://github.com/jeffutter/dokku-postgresql-plugin ) | [jeffutter][] | This plugin creates a single postgresql container that all your apps can use. Thus only one instance of postgresql running (good for servers without a ton of memory). |
| [PostgreSQL (single container) ](https://github.com/ohardy/dokku-psql ) | [ohardy][] | Compatible with 0.2.0 |
2015-03-30 23:24:34 +02:00
| [PostgreSQL (single container) ](https://github.com/Flink/dokku-psql-single-container ) | [Flink][] | Single Postgresql container with official Postgresql docker image. Compatible with 0.3.16 |
2014-11-22 15:37:29 -05:00
| [PostGIS ](https://github.com/fermuch/dokku-pg-plugin ) | [fermuch][] | |
2014-11-17 17:03:22 -05:00
#### Caching
2014-11-22 15:37:29 -05:00
| Plugin | Author | Compatibility |
| ------------------------------------------------------------------------------------------------- | --------------------- | --------------------- |
| [Memcached ](https://github.com/jezdez/dokku-memcached-plugin ) | [jezdez][] | Compatible with 0.2.0 |
| [Memcached ](https://github.com/jlachowski/dokku-memcached-plugin ) | [jlachowski][] | IP & PORT available directly in linked app container env variables (requires link plugin)|
| [Redis ](https://github.com/jezdez/dokku-redis-plugin ) | [jezdez][] | Requires https://github.com/rlaneve/dokku-link; compatible with 0.2.0 |
| [Redis ](https://github.com/luxifer/dokku-redis-plugin ) | [luxifer][] | |
2015-02-22 18:50:46 +10:30
| [Redis ](https://github.com/sekjun9878/dokku-redis-plugin ) | [sekjun9878][] | A better Redis plugin with automatic instance creation and Dokku Link support
2014-11-22 15:37:29 -05:00
| [Redis (single container) ](https://github.com/ohardy/dokku-redis ) | [ohardy][] | Compatible with 0.2.0 |
| [Varnish ](https://github.com/Zenedith/dokku-varnish-plugin ) | [Zenedith][] | Varnish cache between nginx and application with base configuration|
2014-11-17 17:03:22 -05:00
#### Queuing
2014-11-22 15:37:29 -05:00
| Plugin | Author | Compatibility |
| ------------------------------------------------------------------------------------------------- | --------------------- | --------------------- |
| [RabbitMQ ](https://github.com/jlachowski/dokku-rabbitmq-plugin ) | [jlachowski][] | IP & PORT available directly in linked app container env variables (requires link plugin)|
| [RabbitMQ (single container) ](https://github.com/jlachowski/dokku-rabbitmq-single-plugin ) | [jlachowski][] | IP & PORT available directly in linked app container env variables (requires link plugin)|
2014-11-17 17:03:22 -05:00
#### Other
2014-11-22 15:37:29 -05:00
| Plugin | Author | Compatibility |
| ------------------------------------------------------------------------------------------------- | --------------------- | --------------------- |
| [CouchDB ](https://github.com/racehub/dokku-couchdb-plugin ) | [RaceHub][] | Compatible with 0.2.0 |
2015-02-19 00:32:59 -05:00
| [Elasticsearch ](https://github.com/robv/dokku-elasticsearch ) | [robv][] | Not compatible with >= 0.3.0 (still uses /home/git) |
| [Elasticsearch ](https://github.com/jezdez/dokku-elasticsearch-plugin ) | [jezdez][] | Compatible with 0.2.0 to 0.3.13 |
| [Elasticsearch ](https://github.com/blag/dokku-elasticsearch-plugin )<sup>1</sup> | [blag][] | Compatible with 0.2.0 |
2014-11-22 15:37:29 -05:00
| [MongoDB (single container) ](https://github.com/jeffutter/dokku-mongodb-plugin ) | [jeffutter][] | |
| [RethinkDB ](https://github.com/stuartpb/dokku-rethinkdb-plugin ) | [stuartpb][] | 2014-02-22: targeting dokku @ [latest][217d00a]; will fail with Dokku earlier than [28de3ec][]. |
| [RiakCS (single container) ](https://github.com/jeffutter/dokku-riakcs-plugin ) | [jeffutter][] | Incompatible with 0.2.0 (checked at [dccee02][]) |
| [Neo4j ](https://github.com/Aomitayo/dokku-neo4j-plugin ) | [Aomitayo][] | |
2014-10-04 04:24:22 -04:00
[dccee02]: https://github.com/jeffutter/dokku-riakcs-plugin/commit/dccee02702e7001851917b7814e78a99148fb709
### Process Managers
2014-11-22 15:37:29 -05:00
| Plugin | Author | Compatibility |
| ------------------------------------------------------------------------------------------------- | --------------------- | --------------------- |
| [Circus ](https://github.com/apmorton/dokku-circus ) | [apmorton][] | |
| [Shoreman ](https://github.com/statianzo/dokku-shoreman ) | [statianzo][] | Compatible with 0.2.0 |
| [Supervisord ](https://github.com/statianzo/dokku-supervisord ) | [statianzo][] | Compatible with 0.2.0 |
| [Logging Supervisord ](https://github.com/sehrope/dokku-logging-supervisord ) | [sehrope][] | Works with dokku @ [c77cbf1][] - no 0.2.0 compatibility |
| [Forego ](https://github.com/iskandar/dokku-forego ) | [iskandar][] | Compatible with 0.2.x |
2015-04-28 15:53:32 +02:00
| [Monit ](https://github.com/cjblomqvist/dokku-monit )<sup>1</sup> | [cjblomqvist][] | |
2014-10-04 04:24:22 -04:00
[c77cbf1]: https://github.com/progrium/dokku/commit/c77cbf1d3ae07f0eafb85082ed7edcae9e836147
[28de3ec]: https://github.com/progrium/dokku/commit/28de3ecaa3231a223f83fd8d03f373308673bc40
2015-04-28 15:53:32 +02:00
<sup>1</sup> This plugin is far from complete and a mere proof-of-concept of how Monit can be used to externally monitor dokku apps. Read the [README ](https://github.com/cjblomqvist/dokku-monit ) for more details or contact the author.
2014-10-04 04:24:22 -04:00
### Dokku Features
2014-11-22 15:37:29 -05:00
| Plugin | Author | Compatibility |
| ------------------------------------------------------------------------------------------------- | --------------------- | --------------------- |
| [app-url ](https://github.com/mikecsh/dokku-app-url ) | [mikecsh][] | Works with 0.2.0 |
| [Docker Direct ](https://github.com/heichblatt/dokku-docker-direct ) | [heichblatt][] | |
| [Dokku Name ](https://github.com/alex-sherwin/dokku-name ) | [alex-sherwin][] | dokku >= [c77cbf1][] |
2015-02-19 00:32:59 -05:00
| [Dokku Registry ](https://github.com/agco-adm/dokku-registry )<sup>1</sup> | [agco-adm][] | |
2014-11-22 15:37:29 -05:00
| [git rev-parse HEAD in env ](https://github.com/nornagon/dokku-git-rev ) | [nornagon][] | Compatible with 0.2.0 |
2015-04-12 03:24:03 +10:00
| [Graduate (Environment Management) ](https://github.com/glassechidna/dokku-graduate ) | [Benjamin-Dobell][] | dokku >= v0.3.14 |
2014-11-22 15:37:29 -05:00
| [HTTP Auth Secure Apps ](https://github.com/matto1990/dokku-secure-apps ) | [matto1990][] | Works with v0.2.3 |
| [Host Port binding ](https://github.com/stuartpb/dokku-bind-port ) | [stuartpb][] | dokku >= [c77cbf1][]. 2014-02-17: [a043e98][] targeting dokku @ [latest][217d00a] |
| [Hostname ](https://github.com/michaelshobbs/dokku-hostname ) | [michaelshobbs][] | |
| [Link Containers ](https://github.com/rlaneve/dokku-link ) | [rlaneve][] | dokku >= [c77cbf1][] |
| [Multi-Buildpack ](https://github.com/pauldub/dokku-multi-buildpack ) | [pauldub][] | |
| [Nginx-Alt ](https://github.com/mikexstudios/dokku-nginx-alt ) | [mikexstudios][] | Works with v0.2.3 |
| [Persistent Storage ](https://github.com/dyson/dokku-persistent-storage ) | [dyson][] | Requires dokku >= [c77cbf1][] |
| [Ports ](https://github.com/heichblatt/dokku-ports ) | [heichblatt][] | |
| [Pre-Deploy Tasks ](https://github.com/michaelshobbs/dokku-app-predeploy-tasks ) | [michaelshobbs][] | |
| [SSH Deployment Keys ](https://github.com/cedricziel/dokku-deployment-keys )<sup>2</sup> | [cedricziel][] | 2014-01-17: compatible with upstream/master |
| [SSH Hostkeys ](https://github.com/cedricziel/dokku-hostkeys-plugin )<sup>3</sup> | [cedricziel][] | 2014-01-17: compatible with upstream/master |
| [VHOSTS Custom Configuration ](https://github.com/neam/dokku-nginx-vhosts-custom-configuration ) | [motin][] | Compatible with 0.3.1 |
| [Volume (persistent storage) ](https://github.com/ohardy/dokku-volume ) | [ohardy][] | Compatible with 0.2.0 |
2015-03-16 23:57:06 +01:00
| [Maintenance mode ](https://github.com/Flink/dokku-maintenance ) | [Flink][] | |
| [HTTP Auth ](https://github.com/Flink/dokku-http-auth ) | [Flink][] | |
2014-10-04 04:24:22 -04:00
[8fca220]: https://github.com/progrium/dokku/commit/8fca2204edb0017796d6915ca9157c05b1238e28
[217d00a]: https://github.com/progrium/dokku/commit/217d00a1bc47a7e24d8847617bb08a1633025fc7
[98332de]: https://github.com/dyson/dokku-persistent-storage/commit/98332de4b5b640610bee535f4d5260263074e18b
[a043e98]: https://github.com/stuartpb/dokku-bind-port/commit/a043e9892f4815b6525c850131e09fd64db5c1fa
2015-02-19 00:32:59 -05:00
<sup>1</sup> On Heroku similar functionality is offered by the [heroku-labs pipeline feature ](https://devcenter.heroku.com/articles/labs-pipelines ), which allows you to promote builds across multiple environments (staging -> production)
2014-10-04 04:24:22 -04:00
<sup>2</sup> Adds the possibility to add SSH deployment keys to receive private hosted packages
<sup>3</sup> Adds the ability to add custom hosts to the containers known_hosts file to be able to ssh them easily (useful with deployment keys)
2015-02-19 00:32:59 -05:00
### Other Plugins
2014-10-04 04:24:22 -04:00
2014-11-22 15:37:29 -05:00
| Plugin | Author | Compatibility |
| ------------------------------------------------------------------------------------------------- | --------------------- | --------------------- |
2015-03-19 10:55:50 +02:00
| [Wordpress ](https://github.com/dudagroup/dokku-wordpress-template ) | [abossard][] | Dokku dev, mariadb, volume, domains |
2014-11-22 15:37:29 -05:00
| [Node ](https://github.com/pnegahdar/dokku-node ) | [pnegahdar][] | |
| [Node ](https://github.com/ademuk/dokku-nodejs ) | [ademuk][] | |
| [Chef cookbooks ](https://github.com/fgrehm/chef-dokku ) | [fgrehm][] | |
| [Bower install ](https://github.com/alexanderbeletsky/dokku-bower-install ) | [alexanderbeletsky][] | |
| [Bower/Grunt ](https://github.com/thrashr888/dokku-bower-grunt-build-plugin ) | [thrashr888][] | |
| [Bower/Gulp ](https://github.com/gdi2290/dokku-bower-gulp-build-plugin ) | [gdi2290][] | |
| [HipChat Notifications ](https://github.com/cef/dokku-hipchat ) | [cef][] | |
2015-03-23 13:29:08 +02:00
| [Slack Notifications ](https://github.com/ribot/dokku-slack ) | [ribot][] | |
2014-11-22 15:37:29 -05:00
| [Graphite/statsd ](https://github.com/jlachowski/dokku-graphite-plugin ) | [jlachowski][] | |
| [APT ](https://github.com/F4-Group/dokku-apt ) | [F4-Group][] | |
| [User ACL ](https://github.com/mlebkowski/dokku-acl ) | [Maciej Łebkowski][] | |
| [PrimeCache ](https://github.com/darkpixel/dokku-prime-cache ) | [darkpixel][] | |
2015-03-10 15:27:54 +01:00
| [Webhooks ](https://github.com/nickstenning/dokku-webhooks ) | [nickstenning][] | |
2015-03-14 01:40:03 +01:00
| [Rails logs ](https://github.com/Flink/dokku-rails-logs ) | [Flink][] | |
2015-03-23 22:26:45 +01:00
| [Airbrake deploy ](https://github.com/Flink/dokku-airbrake-deploy ) | [Flink][] | |
2014-10-04 04:24:22 -04:00
<sup>1</sup> Forked from [jezdez/dokku-elasticsearch-plugin ](https://github.com/jezdez/dokku-elasticsearch-plugin ): uses Elasticsearch 1.2 (instead of 0.90), doesn't depend on dokku-link, runs as elasticsearch user instead of root, and turns off multicast autodiscovery for use in a VPS environment.
2015-02-19 00:32:59 -05:00
### Deprecated Plugins
The following plugins have been removed as their functionality is now in Dokku Core.
2015-04-01 12:58:46 -07:00
| Plugin | Author | In Dokku Since |
| ------------------------------------------------------------------------------------------------- | --------------------- | ------------------------------- |
| [Custom Domains ](https://github.com/neam/dokku-custom-domains ) | [motin][] | v0.3.10 (domains plugin) |
| [Debug ](https://github.com/heichblatt/dokku-debug ) | [heichblatt][] | v0.3.9 (trace command) |
| [Docker Options ](https://github.com/dyson/dokku-docker-options ) | [dyson][] | v0.3.17 (docker-options plugin) |
| [Multiple Domains ](https://github.com/wmluke/dokku-domains-plugin )<sup>1</sup> | [wmluke][] | v0.3.10 (domains plugin) |
| [Rebuild application ](https://github.com/scottatron/dokku-rebuild ) | [scottatron][] | v0.3.14 (ps plugin) |
| [Supply env vars to buildpacks ](https://github.com/cameron-martin/dokku-build-env )<sup>2</sup> | [cameron-martin][] | v0.3.9 (build-env plugin) |
| [user-env-compile ](https://github.com/musicglue/dokku-user-env-compile )<sup>2</sup> | [musicglue][] | v0.3.9 (build-env plugin) |
| [user-env-compile ](https://github.com/motin/dokku-user-env-compile )<sup>2</sup> | [motin][] | v0.3.9 (build-env plugin) |
2015-02-19 00:32:59 -05:00
<sup>1</sup> Conflicts with [VHOSTS Custom Configuration ](https://github.com/neam/dokku-nginx-vhosts-custom-configuration )
<sup>2</sup> Similar to the heroku-labs feature (see https://devcenter.heroku.com/articles/labs-user-env-compile)
