From dd9ef4866cac62e6402009c57bc2025fb678da6a Mon Sep 17 00:00:00 2001 From: Jose Diaz-Gonzalez Date: Wed, 7 Jan 2015 00:43:08 -0500 Subject: [PATCH] Add advanced installation docs that were removed in #706. Closes #869 --- docs/advanced-installation.md | 37 +++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 docs/advanced-installation.md diff --git a/docs/advanced-installation.md b/docs/advanced-installation.md new file mode 100644 index 000000000..3a1648712 --- /dev/null +++ b/docs/advanced-installation.md @@ -0,0 +1,37 @@ +#Advanced installation + +## Development + +If you plan on developing dokku, the easiest way to install from your own repository is cloning the repository and calling the install script. Example: + +```shell +git clone https://github.com/yourusername/dokku.git +cd dokku +sudo make install +``` + +The `Makefile` allows source URLs to be overridden to include customizations from your own repositories. The `DOCKER_URL`, `PLUGINHOOK_URL`, `SSHCOMMAND_URL` and `STACK_URL` environment variables may be set to override the defaults (see the `Makefile` for how these apply). Example: + +```shell +sudo SSHCOMMAND_URL=https://raw.github.com/yourusername/sshcommand/master/gitreceive make install +``` + +## Bootstrap a server from your own repository + +The bootstrap script allows the dokku repository URL to be overridden to bootstrap a host from your own clone of dokku using the `DOKKU_REPO` environment variable. Example: + +```shell +wget https://raw.github.com/progrium/dokku/master/bootstrap.sh +chmod +x bootstrap.sh +sudo DOKKU_REPO=https://github.com/yourusername/dokku.git ./bootstrap.sh +``` + +## Custom buildstep build + +Dokku ships with a pre-built version of version of the [buildstep](https://github.com/progrium/buildstep) component by default. If you want to build your own version you can specify that with an env variable. + +```shell +git clone https://github.com/progrium/dokku.git +cd dokku +sudo BUILD_STACK=true make install +```