You can always install Dokku straight from the latest - potentially unstable - master release via the following bash command:
# using a branch results in installing from source wget https://raw.githubusercontent.com/dokku/dokku/master/bootstrap.sh; sudo DOKKU_BRANCH=master bash bootstrap.sh
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:
git clone https://github.com/yourusername/dokku.git cd dokku sudo make install
Makefile allows source URLs to be overridden to include customizations from your own repositories. The
STACK_URL environment variables may be set to override the defaults (see the
Makefile for how these apply). Example:
sudo SSHCOMMAND_URL=https://raw.githubusercontent.com/yourusername/sshcommand/master/sshcommand make install
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:
wget https://raw.githubusercontent.com/dokku/dokku/master/bootstrap.sh; chmod +x bootstrap.sh sudo DOKKU_REPO=https://github.com/yourusername/dokku.git DOKKU_BRANCH=master ./bootstrap.sh
Dokku ships with a pre-built version of version of the herokuish component by default. If you want to build your own version you can specify that with an env variable.
git clone https://github.com/dokku/dokku.git cd dokku sudo BUILD_STACK=true STACK_URL=https://github.com/gliderlabs/herokuish.git make install
herokuish package is recommended but not required if not using Heroku Buildpacks for deployment. Debian-based OS users can run the bootstrap installer via
sudo DOKKU_NO_INSTALL_RECOMMENDS=true bash bootstrap.sh to skip the dependency. Please note that this will also skip installation of other recommended dependencies.
Once Dokku is installed, if you are not using the web-installer, you'll want to configure a the virtualhost setup as well as the push user. If you do not, your installation will be considered incomplete and you will not be able to deploy applications.
You should also stop and disable the
dokku-installer service to remove public access to adding SSH keys.
Set up a domain and a wildcard domain pointing to that host. Make sure
/home/dokku/VHOST is set to this domain. By default it's set to whatever hostname the host has. This file is only created if the hostname can be resolved by dig (
dig +short $(hostname -f)). Otherwise you have to create the file manually and set it to your preferred domain. If this file still is not present when you push your app, Dokku will publish the app with a port number (i.e.
http://example.com:49154 - note the missing subdomain).
Follow the user management documentation in order to add users to Dokku, or to give other Unix accounts access to Dokku.
Having less than 1GB of system memory available for Dokku and its containers, for example Digital Ocean's small 512MB machines, might result in unexpected errors, such as ! [remote rejected] master -> master (pre-receive hook declined) during installation of NPM dependencies (https://github.com/npm/npm/issues/3867).
To work around this issue, it might suffice to augment the linux swap file size to a maximum of twice the physical memory size.
To resize the swap file of a 512MB machine to 1GB, follow these steps while in SSH within your machine:
cd /var touch swap.img chmod 600 swap.img dd if=/dev/zero of=/var/swap.img bs=1024k count=1000 mkswap /var/swap.img swapon /var/swap.img free echo "/var/swap.img none swap sw 0 0" >> /etc/fstab